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SPECIFICATION 



TO ALL WHOM IT MAY CONCERN: 

Be it known that we, Mark Lucovsky, Paul Steckler, Walter Hsueh, Kendall Keil and 
Burra Gopal have invented a certain new and useful SCHEMA-BASED SERVICES FOR 
IDENTITY-BASED ACCESS TO CALENDAR DATA of which the following is a 
specification. 
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SCHEMA-BASED SERVICES FOR IDENTITY-BASED ACCESS 

TO CALENDAR DATA 

CROSS REFERENCE TO RELATED APPLICATIONS 

5 The present application claims priority from co-pending United States provisional 

application serial number 60/275,809, filed March 14, 2001 and entitled 'Identity-Based 
Service Communication Using XML Messaging Interfaces", which is hereby incorporated 
herein by reference in its entirety. The present application is related to United States Patent 

Application serial number entitled Schema-Based Services for Identity-Based 

^ J. 1 0 Data Access, filed concurrently herewith on October 22, 200 1 . 

b 
ru 

Ifi COPYRIGHT DISCLAIMER 

A portion of the disclosure of this patent document contains material that is subject to 

a 

copyright protection. The copyright owner has no objection to the facsimile reproduction by 

C3 

1 5 anyone of the patent document or the patent disclosure as it appears in the Patent and 
p Trademark Office patent file or records, but otherwise reserves all copyright rights 
whatsoever. 

FIELD OF THE INVENTION 

20 The invention relates generally to computer network data access, and more particularly 

to systems, methods and data structures for accessing data and data-related services over a 
network. 
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= ^ BACKGROUND OF THE INVENTION 

sao 

There are many types of data that users need to manage and otherwise access. For 
example, users keep word processing documents, spreadsheet documents, calendars, 
telephone numbers and addresses, e-mail messages, financial information and so on. In 
5 general, users maintain this information on various personal computers, hand-held computers, 
pocket-sized computers, personal digital assistants, mobile phones and other electronic 
devices. In most cases, a user's data on one device is not accessible to another device, without 
some manual synchronization process or the like to exchange the data, which is cumbersome. 
Moreover, some devices do not readily allow for synchronization. For example, if a user 

If 

y 10 leaves his cell phone at work, he has no way to get his stored phone numbers off the cell 



phone when at home, even if the user has a computing device or similar cell phone at his 



fj^ disposal. As is evident, these drawbacks result from the separate devices each containing their 



s own data. 

|f; Corporate networks and the like can provide users with remote access to some of their 

fU 

1 5 data, but many users do not have access to such a network. For many of those that have 
access, connecting to a network with the many different types of devices, assuming such 
devices can even connect to a network, can be a complex or overwhelming problem. 

Moreover, even if a user has centrally stored data, the user needs the correct type of 
device running the appropriate application program to access that data. For example, a user 

20 with a PDA that maintains a user's schedule (e.g., appointments, meetings and so on) with a 
simple to-do list application program ordinarily will not be able to use that program to open a 
calendar stored by an email application program or the like at work. In general, this is 
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because the data is fonnatted and accessed according to the way the application program 
wants it to be formatted. 

What is needed is a model wherein data is centrally stored for users, with a set of 
services that control access to the data with defined methods, regardless of the application 
5 program and/or device. 



SUMMARY OF THE INVENTION 
Briefly, the present invention provides a Calendar service for central (e.g., Internet) 
access to per-user contact data, based on each user's identity, wherein the calendar service 
10 includes a schema that defines rules and a structure for the data, and also includes methods 

?5 3 

ly 

^ that provide access to the data in a defined way. Because the structure of the data is defined 

ess 

CR from the perspective of the data, not firom that of an application program or a device, 

SSStl 

f programs can communicate with the services to access the data, with existing knowledge of 

?s 2 the format. In one implementation, the Calendar schemas are arranged as XML documents, 

flJ 

[3 15 and the services provide methods that control access to the data based on the requesting user's 
identification, defined role and scope for that role. In this way, data can be accessed by its 
owner, and shared to an extent determined by the owner. Extensibility is defined into the 
schema. 

Other benefits and advantages will become apparent firom the following detailed 
20 description when taken in conjunction with the drawings, in which: 
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BRIEF DESCRIPTION OF THE DRAWINGS 

FIGURE 1 is a block diagram representing an exemplary computer system into which 
the present invention maybe incorporated; 
5 FIG. 2 is a block diagram representing a generic data access model in accordance with 

one aspect of the present invention; 

FIG. 3 is a representation of services for identity-based data access in accordance with 
one aspect of the present invention; and 

FIG. 4 is a block diagram representing a schema-based service for accessing data 

C3 10 arranged in a logical content document based on a defined schema for that service in 

C3 

accordance with one aspect of the present invention. 

ru 

Cm 

T DETAILED DESCRIPTION 

a EXEMPLARY OPERATING ENVIRONMENT 

ru 

15 FIGURE 1 illustrates an example of a suitable computing system environment 100 on 

which the invention may be implemented. The computing system environment 100 is only 
one example of a suitable computing environment and is not intended to suggest any 
limitation as to the scope of use or functionaUty of the invention. Neither should the 
computing environment 100 be interpreted as having any dependency or requirement relating 

20 to any one or combination of components illustrated in the exemplary operating environment 
100. 

The invention is operational with numerous other general purpose or special purpose 
computing system environments or configurations. Examples of well known computing 
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systems, environments, and/or configurations that may be suitable for use with the invention 
include, but are not limited to: personal computers, server computers, hand-held or laptop 
devices, tablet devices, multiprocessor systems, microprocessor-based systems, set top boxes, 
programmable consumer electronics, network PCs, minicomputers, mainfi-ame computers, 
5 distributed computing environments that include any of the above systems or devices, and the 
like. 

The invention may be described in the general context of computer-executable 
instructions, such as program modules, being executed by a computer. Generally, program 
modules include routines, programs, objects, components, data structures, and so forth, that 
Q 10 perform particular tasks or implement particular abstract data types. The invention may also 
FU be practiced in distributed computing environments where tasks are performed by remote 
I processing devices that are linked through a communications network, hi a distributed 

sbst 

g computing environment, program modules may be located in local and/or remote computer 

p storage media including memory storage devices. 

ry 

f U 1 5 With reference to FIG. 1 , an exemplary system for implementing the invention 

includes a general purpose computing device in the form of a computer 110. Components of 
the computer 110 may include, but are not limited to, a processing unit 120, a system memory 
130, and a system bus 121 that couples various system components including the system 
memory to the processing unit 120. The system bus 121 may be any of several types of bus 
20 structures including a memory bus or memory controller, a peripheral bus, and a local bus 
using any of a variety of bus architectures. By way of example, and not limitation, such 
architectures include Lidustry Standard Architecture (ISA) bus, Micro Channel Architecture 
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(MCA) bus, Enhanced ISA (EISA) bus, Video Electronics Standards Association (VESA) 
local bus, and Peripheral Component Interconnect (PCI) bus also known as Mezzanine bus. 

The computer 1 10 typically includes a variety of computer-readable media. 
Computer-readable media can be any available media that can be accessed by the computer 
5 110 and includes both volatile and nonvolatile media, and removable and non-removable 
media. By way of example, and not limitation, computer-readable media may comprise 
computer storage media and communication media. Computer storage media includes both 
volatile and nonvolatile, removable and non-removable media implemented in any method or 
technology for storage of information such as computer-readable instructions, data structures, 

i s 

p 10 program modules or other data. Computer storage media includes, but is not limited to, 

n 

rU RAM, ROM, EEPROM, flash memory or other memory technology, CD-ROM, digital 
versatile disks (DVD) or other optical disk storage, magnetic cassettes, magnetic tape, 
'J^ magnetic disk storage or other magnetic storage devices, or any other medium which can be 
p used to store the desired information and which can accessed by the computer 110. 

ru 

ry 1 5 Communication media typically embodies computer-readable instructions, data structures, 

Q 

^~ program modules or other data in a modulated data signal such as a carrier wave or other 

transport mechanism and includes any information delivery media. The term "modulated data 
signal" means a signal that has one or more of its characteristics set or changed in such a 
manner as to encode information in the signal. By way of example, and not limitation, 
20 communication media includes wired media such as a wired network or direct-wired 



connection, and wireless media such as acoustic, RF, infrared and other wireless media. 



Combinations of the any of the above should also be included within the scope of computer- 
readable media. 
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The system memory 130 includes computer storage media in the form of volatile 
and/or nonvolatile memory such as read only memory (ROM) 131 and random access memory 
(RAM) 132. A basic input/output system 133 (BIOS), containing the basic routines that help 
to transfer information between elements within computer 110, such as during start-up, is 
typically stored in ROM 131. RAM 1 32 typically contains data and/or program modules that 
are immediately accessible to and/or presently being operated on by processing xmit 120. By 
way of example, and not limitation, FIG. 1 illustrates operating system 134, application 
programs 135, other program modules 136 and program data 137. 

The computer 110 may also include other removable/non-removable, 
volatile/nonvolatile computer storage media. By way of example only, FIG. 1 illustrates a 
hard disk drive 141 that reads from or writes to non-removable, nonvolatile magnetic media, a 
magnetic disk drive 151 that reads from or writes to a removable, nonvolatile magnetic disk 
152, and an optical disk drive 155 that reads from or writes to a removable, nonvolatile optical 
disk 156 such as a CD ROM or other optical media. Other removable/non-removable, 
volatile/nonvolatile computer storage media that can be used in the exemplary operating 
environment include, but are not limited to, magnetic tape cassettes, flash memory cards, 
digital versatile disks, digital video tape, solid state RAM, solid state ROM, and the like. The 
hard disk drive 141 is typically connected to the system bus 121 through a non-removable 
memory interface such as interface 140, and magnetic disk drive 151 and optical disk drive 
155 are typically connected to the system bus 121 by a removable memory interface, such as 
interface 150. 

The drives and their associated computer storage media, discussed above and 
illustrated in FIG. 1, provide storage of computer-readable instructions, data structures. 



program modules and other data for the computer 1 10. In FIG. 1, for example, hard disk drive 
141 is illustrated as storing operating system 144, application programs 145, other program 
modules 146 and program data 147. Note that these components can either be the same as or 
different from operating system 134, application programs 135, other program modules 136, 
and program data 137. Operating system 144, application programs 145, other program 
modules 146, and program data 147 are given different numbers herein to illustrate that, at a 
minimum, they are different copies. A user may enter commands and information into the 
computer 20 through input devices such as a tablet, or electronic digitizer, 164, a microphone 
163, a keyboard 162 and pointing device 161, commonly referred to as mouse, trackball or 
touch pad. Other input devices not shown in FIG. 1 may include a joystick, game pad, 
satellite dish, scanner, or the like. These and other input devices are often connected to the 
processing unit 120 through a user input interface 160 that is coupled to the system bus, but 
may be connected by other interface and bus structures, such as a parallel port, game port or a 
universal serial bus (USB). A monitor 191 or other type of display device is also connected to 
the system bus 121 via an interface, such as a video interface 190. The monitor 191 may also 
be integrated with a touch-screen panel or the like. Note that the monitor and/or touch screen 
panel can be physically coupled to a housing in which the computing device 1 10 is 
incorporated, such as in a tablet-type personal computer. In addition, computers such as the 
computing device 110 may also include other peripheral output devices such as speakers 195 
and printer 196, which may be connected through an output peripheral interface 194 or the 
like. 

The computer 110 may operate in a networked environment using logical connections 
to one or more remote computers, such as a remote computer 180. The remote computer 180 




may be a personal computer, a server, a router, a network PC, a peer device or other common 
network node, and typically includes many or all of the elements described above relative to 
the computer 110, although only a memory storage device 181 has been illustrated in FIG. 1. 
The logical connections depicted in FIG. 1 include a local area network (LAN) 171 and a wide 
5 area network (WAN) 1 73, but may also include other networks. Such networking 

environments are commonplace in offices, enterprise-wide computer networks, intranets and 
the Intemet. For example, in the present invention, the computer system 1 10 may comprise 
source machine from which data is being migrated, and the remote computer 180 may 
comprise the destination machine. Note however that source and destination machines need 
f ? 1 0 not be connected by a network or any other means, but instead, data may be migrated via any 

ru 

M media capable of being written by the source platform and read by the destination platform or 

fli 

Cn platforms. 

^ When used in a LAN networking environment, the computer 1 10 is connected to the 

fii LAN 171 through a network interface or adapter 170. When used in a WAN networking 

ry 

C3 15 environment, the computer 110 typically includes a modem 172 or other means for 

e . 
PA 

establishing communications over the WAN 173, such as the Intemet. The modem 172, 
which may be internal or external, may be connected to the system bus 121 via the user input 
interface 160 or other appropriate mechanism. In a networked environment, program modules 
depicted relative to the computer 1 10, or portions thereof, may be stored in the remote 
20 memory storage device. By way of example, and not limitation, FIG. 1 illustrates remote 
application programs 185 as residing on memory device 181. It will be appreciated that the 
network connections shown are exemplary and other means of establishing a communications 
link between the computers may be used. 



DATA ACCESS MODEL 

The present invention generally operates in an architecture / platform that connects 
network-based (e.g., Internet-based) applications, devices and services, and transforms them 
into a user's personal network which works on the user's behalf, and with permissions granted 
by the user. To this end, the present invention is generally directed to schema-based services 
that maintain user, group, corporate or other entity data in a commonly accessible virtual 
location, such as the Internet. The present invention is intended to scale to millions of users, 
and be stored reliably, and thus it is likely that a user's data will be distributed among and/or 



10 repUcated to numerous storage devices, such as controlled via a server federation. As such, 

ru 

14 while the present invention will be generally described with respect to an identity-centric 

ru 

CP model that enables a user with an appropriate identity and credentials to access data by 

f ^ communicating with various core or other services, it is understood that the schema-based 
services described herein are arranged for handling the data of millions of users, sorted on a 



Q 15 per-user-identity basis. Note that while "user" is generally employed herein for simplicity, as 

i « 

used herein the term "user" is really a substitute for any identity, which may be a user, a 
group, another entity, an event, a project, and so on. 

As generally represented in FIG. 2, a data access model 200 includes a generic 
navigation module 202 through which applications 204 and the like may access a wide variety 
20 of identity-based data, such as maintained in an addressable store 206. To access the data, a 
common set of command methods may be used to perform operations on various data 
structures that are constructed from the data in the addressable store 206, even though each of 
those data structures may represent different data and be organized quite differently. Such 
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command methods may describe generic operations that may be desired on a wide variety of 
data structures, and include, for example, insert, delete, replace, update, query or changequery 
methods. 

In accordance with one aspect of the present invention and as described in detail 
below, the data is accessed according to various schemas, with the schemas corresponding to 
identity-based services through which users access their data. As used herein, a "schema" 
generally comprises a set of rules that define how a data structure may be organized, e.g., what 
elements are supported, in what order they appear, how many times they appear, and so on. In 
addition, a schema may define, via color-coding or other identification mechanisms, what 
portions of an XML document (that corresponds to the data structure) may be operated on. 
Examples of such XML-based documents are described below. The schema may also define 
how the structure of the XML document may be extended to include elements not expressly 
mentioned in the schema. 

As will be understood below, the schemas vary depending on the type of data they are 
intended to organize, e.g., an email-inbox-related schema organizes data differently firom a 
schema that organizes a user's favorite websites. Further, the services that employ schemas 
may vary. As such, the generic navigation module 202 has associated therewith a navigation 
assistance module 208 that includes or is otherwise associated with one or more schemas 210. 
As will be understood, a navigation assistance module 208 as represented in FIG. 2 
corresponds to one or more services, and possesses the information that defines how to 
navigate through the various data structures, and may also indicate which command methods 
may be executed on what portions of the data structure. Although in FIG. 2 only one 
navigation assistance module 208 is shown coupled to the generic navigation module 202, 



there may be multiple navigation assistance modules that may each specialize as desired. For 
example, each navigation assistance module may correspond to one service. Moreover, 
although the navigation assistance module 208 is illustrated as a separate module, some or all 
of the operations of the navigation assistance module 208 may be incorporated into the 
generic navigation module 202, and vice versa. In one embodiment, the various data 
structures constructed from the schema and addressable store data may comprise XML 
documents of various XML classes. In that case, the navigation assistance module 208 may 
contain a schema associated with each of the classes of XML documents. 

The present invention provides a number of schema-based services that facilitate data 
access based on the identity of a user. Preferably, the user need not obtain a separate identity 
for each service, but rather obtains a single identity via a single set of credentials, such as with 
the Microsoft® Passport online service. With such an identity, a user can access data via these 
services from virtually any network connectable device capable of running an application that 
can call the methods of a service. 

SER VICES AND SCHEMAS 

".NET My Services" comprises identity-centric services which may be generally 
implemented in XML (extensible Markup Language) Message Interfaces (XMIs). While the 
present invention will be described with respect to XML and XMI, it can readily be 
appreciated that the present invention is not limited to any particular language or set of 
interfaces. The .NET My Services model essentially corresponds to one implementation of 
the generic data access model 200 of FIG. 2. 
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As generally represented in FIG. 3, .NET My Services 300 is implemented as a set of 
Web services 301-316, each bound to a .NET Identity (PUID, such as a Passport® unique 
identifier similar to a globally unique indentifier when Passport® is the authentication service). 
The services 301-316 can communicate with one another via a service-to-service 
5 communications protocol (SSCP), described below. As also described below, each service 
presents itself as a set of XML documents that can be manipulated fi-om an application 
program 202 (FIG. 2) or the like using a set of standard methods and domain-specific 
methods. To this end, a user device 320 (endpoint) running such application programs 
connects a user's applications to the services, and the data controlled by those services, such 

5—- 

C3 10 as over the Internet or an Intranet, such as over the Internet or an Intranet. Note that endpoints 

O 

can be client devices, appUcations or services. In keeping with the present invention, virtually 
l~ any device capable of executing software and connecting to a network in any means may thus 

s'xs , 

give a user access to data that the user is allowed to access, such as the user's own data, or 

C3 data that a fiiend or colleague has specified as being accessible to that particular user. 

ry 

[y 1 5 In general, a .NET Identity is an identifier assigned to an individual, a group of 

individuals, or some form of organization or project. Using this identifier, services bound to 
that identity can be located and manipulated. A general effect is that each identity (e.g., of a 
user, group or organization) has tied to it a set of services that are partitioned along schema 
boundaries and across different identities. As will be understood, the XML-document-centric 
20 architecture of .NET My Services provides a model for manipulating and communicating 

service state that is very different fi-om prior data access models. The XML-document-centric 
approach, in conjunction with loose binding to the data exposed by the services, enables new 
classes of application programs. As will also be understood, the .NET My Services model 

-13- 




300 presents the various services 301-316 using a uniform and consistent service and method 
model, a uniform and consistent data access and manipulation model, and a uniform and 
consistent security authorization model. 

In a preferred implementation, the .NET My Services model 300 is based upon open 
5 Intemet standards. Services are accessed by means of SOAP (Simple Object Access Protocol) 
messages containing an XML payload. Service input and output is expressed as XML 
document outlines, and each of these document outlines conform to an XML schema 
document. The content is available to a user interacting with the .NET My Services service 
endpoint 320. 

tjlO Turning to FIG. 4, in the .NET My Services model, an application 400 requests 

6 

I U performance of a method that operates on data structures. The application may make a 
^~ request that is genenc with respect to the type of data structure being operated upon and 

SS 

'J^ without requiring dedicated executable code for manipulating data structures of any particular 
Q data type. To this end, the application first contacts a special myServices service 3 14 to 

ru 

[U 1 5 obtain the information needed to communicate with a particular service 404, through a set of 
methods 406 of that service 404. For example, the needed information received firom the 
myServices service 314 includes a URI of that service 404. Note that the service 404 may 
correspond to essentially any of the services represented in FIG. 3, such as the myCalendar 
service 303. 

20 The service 404 includes or is otherwise associated with a set of methods 406 

including standard methods 408, such as to handle requests directed to insert, delete, replace, 
update, query or changequery operations on the data. The set of methods of a particular 
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service may also include service specific methods 410. In general, the only way in which an 
application can communicate with a service are via that service's methods. 

Each service includes service logic 412 for handling requests and providing suitable 
responses. To this end, the service logic performs various functions such as authorization, 
5 authentication, and signature validation, and further limits valid users to only the data which 
they are permitted to access. The security aspect of a service is not discussed herein, except to 
note that in general, for otherwise valid users, the user's identity determines whether a user 
can access data in a requested manner. To this end, a roleMap 414 comprising service-wide 
roleList document templates 415 and scopes (e.g., part of the overall service's schema 416), in 

g 3 

C3 10 conjimction with user-based data maintained in an addressable store 418, determines whether 



ry 

u 

m 

m 



a particular requested method is allowed, e.g., by forming an identity-based roleList document 
420. If a method is allowed, the scope information in the roleMap 414 determines a shape of 
data to retum, e.g., how much content is allowed to be accessed for this particular user for this 
C3 particular request. The content is obtained in accordance with a content document 422 in the 

ru 

15 service's schema 416 and the actual user data corresponding to that content document in the 
addressable store 418. In this manner, a per-identity shaped content document 424 is 
essentially constructed for returning to the user, or for updating the addressable store, as 
appropriate for the method. Note that FIG. 4 includes a number of ID-based roleList 
documents and ID-based content documents, to emphasize that the service 406 is arranged to 

20 serve multiple users. Also, in FIG. 4, a system document 426 is present as part of the schema 
416, as described below. 

Returning to FIG. 3, in one implementation, access to .NET My Services 300 is 
accomplished using SOAP messages formatted with .NET My Services-specific header and 

- 15- 



body content. Each of the .NET My Services will accept these messages by means of an 
HTTP POST operation, and generate a response by "piggy-backing" on the HTTP Response, 
or by issuing an HTTP POST to a .NET My Services response-processing endpoint 320. In 
addition to HTTP as the message transfer protocol, .NET My Services will support raw SOAP 
5 over TCP, a transfer protocol known as Direct Internet Message Encapsulation (or DIME). 
Other protocols for transferring messages are feasible. 

Because .NET My Services are accessed by protocol, no particular client-side binding 
code, object models, API layers, or equivalents are required, and are thus optional. The .NET 
My Services will support Web Services Description Language (WSDL). It is not mandatory 

C3 10 that appUcations wishing to interact with .NET My Services make use of any particular 

O 



ro 

ry 
m 



bindings, and such bindings are not described herein. Instead, the present invention will be 
generally described in terms of messages that flow between requestors of a particular service 
and the service endpoints. In order to interact with .NET My Services, a service needs to 



C3 format a .NET My Services message and deliver that message to a .NET My Services 

ru 

^ 1 5 endpoint. In order to format a message, a client needs to manipulate XML document outlines, 

M 

and typically perform some simple, known (public-domain) cryptographic operations on 
portions of tiie message. 

In accordance with one aspect of the present invention, and as described in FIG. 4 and 
below, in one preferred implementation, services (including the myCalendar service 303) 
20 present three logical XML documents, a content document 422, roleList docxmient 415 (of the 
roleMap 414), and a system document 426. These documents are addressable using .NET My 
Services message headers, and are manipulated using standard .NET My Services methods. In 
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addition to these common methods, each service may include additional domain-specific 
methods, such as updateContactData. 

Each .NET MyServices service thus logically includes a content document 422, which 
in general is the main, service-specific docimient. The schema for this document 422 is a 
fiinction of the class of service, as will become apparent fi-om the description of the 
myCalendar service's content document below. For example, in the case of the myCalendar 
service 303, the content document presents data in the shape dictated by the .NET My 
Services .myCalendar schema, whereas in the case of the ".NET Favorite WebSites" service 
308, the content document presents data in the shape dictated by a .NET myFavorite WebSites 



O 10 schema. 

ry 



Each service also includes a roleList document 415 that contains roleList information, 



fy 

f fi comprising information that governs access to the data and methods exported by the service 

£ 404. The roleList document is manipulated using the .NET My Services standard data 

s . 

53 manipulation mechanisms. The shape of this document is govemed by the .NET My Services 

1 5 core schema's roleListType XML data type. 



Each service also includes a system document 426, which contains service-specific 
system data such as the roleMap, schemaMap, messageMap, version information, and service 
specific global data. The document is manipulated using the standard .NET data manipulation 
mechanism, although modifications are Umited in a way that allows only the service itself to 
20 modify the document. The shape of this system docxmient 426 may be govemed by the 
system document schema for the particular service, in that each service may extend a base 
system document type with service specific information. 
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As is understood, the present invention is generally based on schemas, which in 
general comprise a set of rules or standards that define how a particular type of data can be 
structured. Via the schemas, the meaning of data, rather than just the data itself, may be 
communicated between computer systems. For example, a computer device may recognize 
that a data structure that follows a particular address schema represents an address, enabling 
the computer to "understand" the component part of an address. The computer device may 
then perform intelligent actions based on the understanding that the data structure represents 
an address. Such actions may include, for example, the presentation of an action menu to the 
user that represents things to do with addresses. Schemas may be stored locally on a device 
and/or globally in a federation's "mega-store." A device can keep a locally-stored schema 
updated by subscribing to an event notification service (in this case, a schema update service) 
that automatically passes messages to the device when the schema is updated. Access to 
globally stored schemas is controlled by the security infrastructure. 

GENERAL SCHEMA COMMONALITY 

The .NET My Services data is defined using annotated XSD schema files. The XSD 
files accurately type the data, but since XSD is a verbose and complex language, it is not a 
particularly efficient way to convey structure and meaning. Thus, for purposes of simplicity 
herein, the myCalendar schemas are described below in terms of schema outlines with 
accompanying element/attribute descriptions. These document outlines accurately show the 
structure of the data contained within a service. However, because the present application is 
not viewable in color, the nodes, elements and/or attributes of the schema outlines (which may 
be described as bold blue, or blue), are represented in the schema outlines as boldface type. 
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Those described as underlined red, or red, are represented as underlined type, while others 
referred to as black are represented in normal type. 

The meaning of these bold (blue), underlined (red) and normal (black) items has 
significance with respect to the data model and to the data language that accesses and 
manipulates the data (e.g., via the insert, delete, replace, update, query, changequery or other 
methods). For example, each document described below contains a root element having an 
element name that matches that of the service, e.g., the myCalendar service has a root element 
named myCalendar. The .NET My Services name for this item is the root. 

Documents contain elements that resemble first-class top-level objects, including, for 
example, <catDe£^> , < myApplicationsSettings /> (other another name as appropriate) and 
<order/>. Such items are denoted in the outlines as bold (blue), and may be identified using 
an <xdb:blue/> tag. Bold (blue) items define major blocks of data within a service. These 
node sets are directly addressable by an identifier attribute, and their change status is tracked 
through a changeNumber attribute. Top-level bold blue items may be considered objects. As 
seen below, some bold (blue) objects contain nested bold blue objects. They usually contain 
fi-equently changing underlined (red) properties, which reduces the amount of synchronization 
traflfic. Nested bold (blue) items may be considered property groups. 

Each bold blue item contains one or more underlined (red) items which are elements 
or attributes. These items may be identified using the <xdb:red/ > tag. These items are special 
in that they may be used within predicates (filters) to aid in xdb:bold blue selection. These 
items are also directly addressable and may be manipulated directly by the data manipulation 
language. 
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Each colored red element may contain one or more non-colorized elements and 
attributes, which are valid and semantically meaningful XML items in the service document. 
Such items are opaque to the data language. These uncolored (i.e., non-bold or underlined) 
elements and attributes may not be addressed directly, may not be selected in a node selection 
operation, and may not be used in a predicate node test. Note that if one of these items is in 
the path to an imderlined red item, it may be used in a location step to the underlined red item, 
but may not be used as the selected node. Note that being opaque does not mean that the item 
is not considered during schema validation, but rather means that the item may not be used in 
a predicate, may not be directly addressed, and may not be inserted by itself. As can be 
readily appreciated, in this manner, the .NET My Services thus limits the granularity of access 
to nodes within the service document, since only xdb:bold blue and xdbiunderlined red 
marked items are directly addressable, and only those elements and attributes tagged with the 
xdb:underlined red annotation may be used in predicates to influence node selection. Using 
this technique, the .NET My Services storage system can efficiently manage indexes, increase 
the performance of node selection, partially shred the document data, and in general (because 
the node selections are well defined) fine-tune the node selection logic on a per-xdb:blue 
basis. The primary purpose of the xdb:blue is to define a base-level XML object that is 
designed to be operated on as a unit. The primary purpose of the xdbrred items is to aid in the 
selection of xdb:bold blues. The xdbired items may be changed by the data language 
primitives so some level of fine-grained manipulation of the data is available, but only in very 
hmited ways. 

Bold blue items have unique E)s, which are usually assigned by .NET My Services, 
and are retumed fi^om update operations within the new blueld node. In all cases, the order of 
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jcxxBold blue follows the pre-order traversal of the document XML tree. Item IDs are UUIDs 
in the following format {h stands for a hexadecimal digit): hhhhhhhh-hhhh-hhhh-hhhh- 
hhhhhhhhhhhh. 

In addition to identifiers, names and change numbers, nodes and especially red nodes 
5 may include creator identifiers, category information, and {any} fields. Category information 
enables data to be grouped and/or distinguished in some way, such as to share certain calendar 
information with golf buddies, send an email to immediately family, designate things such as 
which telephone number is the user's primary number, e.g., if a user has a second home, and 
so on. Fields of type "any" may comprise fiiUy-typed, namespace-qualified fields that contain 

10 any type of content (e.g., fi-ee-form XML) therein. Such "any" fields thus allow extensibility 
of the schema, yet maintain the defined structure of a schema. 

In one implementation, the core data-manipulation language implemented by the .NET 
My Services includes an insertRequest, or insert message. This primitive inserts any schema- 
valid XML fragment into a selected context, thereby changing the existing state of the 

15 document. A queryRequest, or message, retrieves data, such as to retrieve a document. 
Multiple queries maybe specified in one request, and queries that select nothing are 
considered successfiil. It is possible to assert that the nxmiber of nodes in the selection falls in 
a given range. This is expressed using minOccurs and maxOccurs attributes. If a 
minOccurs/maxOccurs test fails on any node, the request is considered unsuccessfiil. Note 

20 that this is different from a failure code, which would be returned, for example, for a 
malformed request. 

A deleteRequest primitive deletes the selected nodes and all their children. Note that, 
just like for other requests, attributes may be selected as well as elements. Empty selections 
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result in successful operations, similar to Query. The minOccurs/maxOccurs tests are 
supported wherever select is allowed. 

A replaceRequest primitive (replace message) is designed to replace the content of 
each of the selected nodes with the specified new content. Selected nodes themselves are not 
5 affected in any way. This may be considered as an atomic delete of the content of the selected 
node, followed by an insert. The content (text, attributes, elements) in the selected nodes are 
replaced with the new item specified in this message. The node type of the selected node and 
of the replacement node are thus required to be the same. The changequery request essentially 
returns resuU comrpising data that has changed. 
C3 10 As mentioned above, each of the services includes a RoleList document and scope 

M 

information that describes which users have what type of access to which data. For example, 
a data owner will have read/write access to his or her own data, and can provide various types 

a'sst 

a of rights to that data to other users based on their IDs, (e.g., read only to some users, read 

C3 write to others). Each role list identifier may be associated with a scope, by which the kinds 

ru 

'J 1 5 of data stored according to a given schema can be controlled per user. For example, a user 
can give a friend (with one identity) access via a service to a home telephone number, home 
address and so forth, but can give other users (with other identities) access only to a business 
telephone number. In general, a scope can be defined such that that it includes everything 
except any specifically listed items, or excludes everything except any specifically listed 
20 items. 
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mvCalendar 

The .NET Calendar service, alternatively referred to herein as myCalendar 303, 
provides calendars for users. This particular service uses an XML schema to describe a typical 
5 calendar, a user's calendar store, and the methods by which calendar data is sent and received 
from the store. 

The .NET Calendar service stores and manages the scheduling of individual and group 
events and appointments that are associated with an identity. This service supplies scheduling 
information on demand to other .NET My Services, applications, and devices. .NET Calendar 
C3 10 can be used for regular scheduling or group collaboration. Group collaborative features 



ru 
cn 



ru 



include meeting delegates and role-based access to another identity's calendar. 

The .NET Calendar service is designed to work with the .NET Alerts service to 
perform reminder alerts and meeting acceptance/decline alerts, with .NET Contacts for service 



E5 distribution Usts, and with .NET Inbox to send and retrieve meeting requests. .NET Inbox will 

ru 



1 5 forward meeting invitations to be direct booked (tentative) on attendee calendars which have 
the correct permissions for this behavior and will forward meeting responses that attendees 
send back to the organizer to update the organizer's calendar. 

.NET Calendar will support calendar publishing. This feature that allows users to 
open their calendars to other users such as friends, family members, and group lists. The .NET 
20 Calendar service uses .NET My Services to support a rich sharing model based upon the 
access control list, role map, and identity header. 

The .NET Calendar schema format improves established existing calendar properties 
and standards. In addition, .NET Calendar establishes a platform for non-Gregorian calendars 
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and additional features such as traveling time allowances for meetings. The schema is 
designed to be extensible to accommodate new calendar properties or additional recurrence 
pattems. 

Throughout the following examples, an "hs" as in <hs: scope . . .> represents the 
5 namespace or schematic that may be used to interpret the corresponding element. 

mvCalendar /Roles 

The myCalendar service controls access by using the rtO, rtl, rt2, rt3 and rt99 
roleTemplates, using the following scopes: 
p 10 scope allElements 

p <hs:scopeid=7215df55-e4af-449f-a8e4-72alf7c6a987> 
f U <hs : shape base=t> 

</hs:shape> 
</hs:scope> 

scope onlySelfElements 

U <hs:scopeid=al59c93d-4010-4460-bc34-5094c49cl633> 
p <hs:shape base=nil> 

rO <hs:include select=//*[@creator='$callerId']/> 

rLJ20 </hs:shape> 
^3 </hs:scope> 

H 

scope onlySelfSubscriptionElements 

<hs:scope id=b7fD5a6d-75cd-4958-9dfb-f532ebbl 7743> 
25 <hs:shape base=nil> 

<hs:include select=//subscription[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

30 scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9fD7e5a5ec8f> 
<hs: shape base=nil> 

<hs:include select=//*[cat/@ref='hs:public']/> 
<hs:include select=//subscription[@creatoi=*$callerId']/> 
35 </hs:shape> 
</hs:scope> 
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The myCalendar rolcTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myCalendar service through that method while mapped to this 
roleTemplate: 



TABLE - myCalendar roleTemplate rtO 



method 


scope/name 


query 


allElements 


insert 


allElements 


replace 


allElements 


delete 


allElements 


update 


allElements 


getCalendarDays 


allElements 


getFrecBusyDays 


allElements 


getQuickView 


allElements 


sendMeeting 


allElements 


respond 


allElements 


updateReminder 


allElements 



The myCalendar roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role also have a limited ability to write to information in the 
content document. They may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
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scope in effect when accessing the myCalendar service through that method while mapped to 
this roleTemplate: 



TABLE - myCalendar roleTemplate rtl 



method 


scoDe/name 


query 


allElements 


insert 


onlySelfElements 


replace 


onlySelfElements 


delete 


onlySelfElements 


update 


allElements 


getCalendarDays 


allElements 


getFreeBusyDays 


allElements 


getQuickView 


onlySelfElements 


sendMeeting 


onlySelfElements 


respond 


onl)^elfElements 



The myCalendar roleTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roleTemplate. 
AppUcations mapping to this role have very limited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the myCalendar service through that method 
while mapped to this roleTemplate: 



TABLE - myCalendar roleTemplate rt2 



method 


scope/name 


query 


allElements 


insert 


onlySelfSubscriptionElements 


replace 


onlySelfSubscriptionElements 


delete 


onlySelfSubscriptionElements 


getCalendarDays 


allElements 


getFreeBusyDays 


allElements 


getQuickView 


allElements 
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The myCalendar roleTemplate rt3 role gives limited read access to information within 
the content document that is categorized as "pubUc." The following table illustrates the 
available methods and the scope in effect when accessing the myCalendar service through that 
method while mapped to this roleTemplate: 



TABLE - myCalendar roleTemplate rt3 



method 


scope/name 


query 


onlyPublicElements 


getCalendarDays 


onlyPublicElements 


getFreeBusyDays 


onlyPublicElements 


getQuickView 


onlyPublicElements 



The myCalendar roleTemplate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. 
myCalendar / Content 

The content document is an identity centric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the myCalendar service: 



<m:myCalendar changeNumber= ". . instanceld-'..." 

xmlns:m="http://schemas.microsoft.com/hs/2001/10/myCalendar" 

xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 

<m:event calendarTvpe ="..." advanceHijriValue-*..." changeNumber= ",.." id="... 

CreatOr =* ' . . . ">0..unbounded 

<m:body changeNumber= "...">i i 
< m:cat ref="...">o..unbounded</ffiicat> 
< m:title xml:lang="..." dir="...">. i< /m;title> 
<m:fullDescription xml:lang="../' dir="...">o..i</ni:fullDescription> 
<m:location xml:lang="..." dir="...">o..i</m:location> 
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<m:meetingStatus>o..i</m:meetingStatus> 
< m : recurr enceld >n i < /ni : r ecur r enceld> 
<m:lastUpdateTime>o..i</m:lastUpdateTime> 
<m:startTime> i i< /ni;startTime> 
<m:endTime> i i< /m;endTime> 
<m:allDay>o..i</m:allDay> 
<m: floating>o.. 1 </ni: floating> 
<m:travelTimeTo>o..i</m:travelTimeTo> 
<m:travelTimeFrom>o„i</m:travelTimeFroni> 
<m: freeBusy Status>o.. 1 </m: freeBusyStatus> 
<m;cuid> o i < /in:cuid > 
<m:organizer>o..i 

<hs:name xml:lang="..." dir="...">o..i</hs:name> 

<hs;puid> n i< /hs;puid> 

< hs;email> n t< /hs;email> 
</m:organizer> 
fany} 
</m:body> 

<m:attendeeEventExtra changeNumb er =' ' . . . ">q i 
<m:intendedFreeBusy>o„i</m:mtendedFreeBusy> 
<in:responseTime>o..i</m:responseTime> 
<m:responseType>o..i</m:responseType> 
<m:counterProposeStartTime>o.i</ni:counterProposeStartTime> 
<m:counterProposeEndTime>o„i</ni:counterProposeEndTime> 
<m:counterProposeLocation>o..i</m:counterProposeLocation> 
<m:responseBody xml:lang="..." dir="...">o..i</m:responseBody> 
<m: delegateResponder>o. 1 

<hs:name xml:lang="..." dir="..;'>o..i</hs:name> 

<hs:puid>o..i</hs:puid> 

<hs:email>o..i</hs:eniail> 
</m: delegateResponder> 
fany} 

</m:attendeeEventExtra> 

<in:attachment changeNumber="..." id="..." creator=" 



'O..uiibounded 



<m:name xnil:lang="..." dir="...">,..i</m:name> 



<m:contentType>i.,i</m:contentType> 

<m:contentTransferEncoding>i..i</ni:contentTransferEncoding> 
<m: size>i i </m: size> 

<m:attachmentBody>i..i</m:attachmentBody> 
</iii:attachment> 

<m:reininder changeNumber= ",.." id="..." creator= "...''>o i 

<m: set>i i</ni: seP" 

<m:to xml:lang="..." dir="...">,..,</m:to> 
<m: off set> 1 1 </m: of f seP^ 
<m:interruptability>o..i</m:interruptability> 
<m : lastSentTime> i i </m: lastSentTimO 
<m;nextTriggerTime> i i< /in:nextTriggerTiine> 
</m:reininder> 
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<iii: attendee changeNumber="..." id="..." creator="...'>o..iinboiiiided 
<hs:name xml:lang="..." dir="...">o..i</hs:name> 
<hs;puid >n i< /hs;puid> 
<hs;email >n i< /hs;emaii> 

<m: inviteType>i i</m:inviteType> 

<m:responseTime>o..i</m:responseTime> 

<m:responseType>o.. i </m:responseType> 

<m:coimterProposeStartTime>o..i</m:counterProposeStartTime> 

<m:counterProposeEndTime>o..i</m:counterProposeEndTime> 

<m:counterProposeLocation>o..i</m:counterProposeLocation> 

<m:responseBody xml:lang="..." dir="...">o..,</ni:responseBody> 

</m:attendee> 

<in:recurrence changeNuinber ='*../'>n t 
<in:rule changeNuinber ="...">i i 

<m:creatioiiDate>i 1 </m:creationDate> 
<m:firstDayOfWeek>i..i</m:firstDayOfWeek> 
<m:tzid>o..i</m:tzid> 
<m:isLeapYear>o..i</m:isLeapYear> 
<m:leapMonthValue>o..i</ni:leapMonthValue> 
<m:repeaP'i.j 
<m:daily dayFrequency="...'*>o..i</ni:daily> 

<m:weekly su="„." mo="..." tu="..." we="..." th="..." fr="..." sa="..;' 
weekFrequency=" . . . ">o.. i </m: weekly> 

<m:monthlyByDay su="..." mo="..." tu="..." we="..." th="..." fr="../' sa="..." 
monthFrequency="..." weekdayOfMonth="...">o.i</ni:monthlyByDay> 

<m:monthly monthFrequency="..." day="..." forceExact="...">o„i</iT^'nionthly> 

<m:yearlyByDay su="..." mo="..;' tu="..." we="..;' th="..;' sa="..." 
yearFrequency='\./' weekdayOfMonth=*\./' month="...">o..i</m:yearlyByDay> 

<m:yearly yearFrequency="..." month="..." day="..." 
forceExact=" . . . ">o. . i </m:yearly> 

ianvi 
</m:repeat> 

<m: windowEnd>o., i </m: windowEnd> 
<m:repeatForever>o.. i </m:repeatF orever> 
<ni:repeatInstances>o,.i</m:repeatInstances> 
<m:deletedExceptionDate>a.unbounded</in:deletedExceptionDate> 

</m:rule> 

<m:exception changeNumber="..." id="..." creator="...'*>o„unboimdcd 
< m : r ecu r r enceld> i i < /m; r ecur r enceld> 

<m:body>o..i 

<m:title xml:lang="..." dir=".,.">o..i</m:title> 
<m:fullDescription xml:lang="..." dir="...">o..!<^/ni:fullDescription> 
<m:location xml:lang="..." dir="...">o..i</ni:location> 
< in:startTime> n i < /m:startTime> 
< in;endTime> n i < /m;endTime> 
<m:allDay>o.i</m:allDay> 
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<m:travelTimeTo>o..i</m:travelTimeTo> 
<m:travelTimeFrom>o„i</m:travelTinieFrom> 
<m:freeBusyStatus>o..i</m:freeBusyStatus> 
<m:organizer>o..i 

<hs:name xml:lang="..." dir="...">o..,</hs:name> 

<hs:puid>o..i</hs:puid> 

<hs:email>o..i</hs:einail> 
</m:organizer> 
</m:body> 

<m:attendeeEventExtra>o„ i 
<m:intendedFreeBusy>o..i</m:intendedFreeBusy> 
<m:responseTime>o..i</m:responseTime> 
<m:responseType>o..i</m:responseType> 
<m:coimterProposeStartTime>o.i</m:counterProposeStartTime> 
<m:counterProposeEndTime>o..i</m:counterProposeEndTime> 
<m:counterProposeLocation>o.i</m:counterProposeLocation> 
<m:responseBody xml:lang="..." dir="...">o..i</m:responseBody> 
<m:delegateResponder>o.. i 

<hs:name xml:lang="..." dir="...">o..i</hs:name> 

<hs:puid>o..i</hs:puid> 

<hs:email>o..i</hs:email> 
</m: delegateResponder> 
{any} 

</m:attendeeEventExtra> 

<m:deletedAttendee>o..unbounded</ni:deletedAttendee> 

<m:deletedAttachment>o,.unbouiided</m:deletedAttachment> 

<m:attachinent>o..unbounded 

<m:name xml:lang="..." dir=",..">,.j</m:name> 

<m:contentType>i..i</m:contentType> 

<m:contentTransferEncoding>i..i</m:contentTransferEncoding> 
<m : size> i i <lm : size> 

<m:attachmentBody>i..i</m:attachmentBody> 
</m:attachment> 
<m:attendee>o..unbounded 

<hs:name xml:lang="..." dir="...">o..i</hs:name> 

<hs:puid>o.. i</hs:puid> 

<hs : emai l>o .. i </hs : email> 

<m: in vi teType> , . . i </m : in vi teType> 

<m:responseTime>o..i</m:responseTime> 

<m:responseType>o..i</m:responseType> 

<m:coimterProposeStartTinie>o„i</m:counterProposeStartTime> 

<m:counterProposeEndTime>o.,i</m:counterProposeEndTime> 

<m:counterProposeLocation>o..i</m:counterProposeLocation> 



<m:responseBody xnil:lang=="..." dir=". 

{any} 
</m:attendee> 
<m:reminder>o..i 

<m: se t>o.. i </m: set> 

<m: off set>o.. i </ni: offset> 



"0,.! 



</m:responseBody> 
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<m:intermptability>o..i</m:interruptability> 
</m:reminder> 
{any} 
</m:exception> 

</m:recurrence> 
<;/iii:event> 

<m:subscription changeNumber="..." id="..." cixator=="...''>o unbounded 

<hs:trigger select=".„" mode="..." baseChangeNumber="...">,..,</hs:trigger> 

<hs : expires At>o.. i </hs : expires At> 

<hs:context uri="...">i..i /a/ix/</hs:context> 

<hs:to>,.,i</hs:to> 
</m:subscriptioii> 

</m:myCalendar> 

The meaning of the attributes and elements shown in the table are set forth below, 

wherein in the syntax used in the table, boldface type corresponds to a blue node, and 

p underlined type to a red node, as described above, and the minimxmi occurrence information 

13 

fU (0, 1) indicates whether an element or attribute is required or optional, and maximum 

M 

5 occurrence information (1 , unbounded) indicates whether one or many are possible. 

The /myCalendar (minOccurs=l maxOccurs=l) element encapsulates the content 

p document for this service. This element establishes a global cache scope for the service and 

ni 

fU contains other root level system attributes for this instance of the service. The 
M /myCalendar/@changeNumber (minOccurs==l maxOccurs=l) changeNumber attribute is 
10 designed to facilitate caching of the element and its descendants. This attribute is assigned to 
this element by the .NET My Services system. The attribute is read only to applications. 
Attempts to write this attribute are silently ignored. The /myCalendar/@instanceId (string 
minOccurs=0 maxOccurs=l) attribute is a unique identifier typically assigned to the root 
element of a service. It is a read-only element and assigned by the .NET My Services system 
1 5 when a particular service is provisioned for a user. 
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The /myCalendar/event (minOccurs=0 maxOccurs=unboimded) event is the 
myCalendar root object for calendar events, appointments, and meetings. 

The /myCalendar/event/@calendarType (string minOccurs=0 maxOcciirs=l) field 



identifies an enumeration which determines the kind of calendar event this is. 



\/5llll A 
V diUC 


PniimprfitiriTi r^nn^tiiiit 


Descriotion 


-1 


HSCAL_ALL_CALENDARS 


Unknown Calendar: svstem default 
(HSCAL_GREGORIAN_US) | 


1 


HSCAL GREGORIAN 


Gregorian (localized) calendar | 


2 


HSCAL GREGORIAN US 


Gregorian (U.S.) calendar | 


3 


HSCAL JAPAN 


Japanese Emperor Era calendar | 


4 


HSCAL TAIWAN 


Taiwan Era calendar ] 


5 


HSCAL KOREA 


Korean Tangun Era calendar | 


yj 


HSCAL HURT 

xxkJV/xVL^ xxx»rxvx 


Hijri (Arabic Lunar) calendar | 


7 


HSCAL THAI 

XXU\— '-/i 1 ^ XXX4VX 


Thai calendar 


o 


HSCAL HEBREW 

1 i.KJ*i - » ^ XXl /I ^XX 1 TT 


Hebrew (Lunar) calendar 


o 


HSCAL GREGORIAN ME FRENCH 


Gregorian Middle East French calendar 


10 


HSCAL GREGORIAN ARABIC 


Gregorian Arabic calendar 


11 


HSCAL_GREGORIAN_XLIT_ENGLISH 


Gregorian TransUterated EngUsh 
calendar 


12 


HSCAL GREGORIAN XLIT FRENCH 


Gregorian Transliterated French calendar 


13 


HSCAL KOREA LUNAR 


Default Korea Lunar calendar 


14 


HSCAL JAPAN LUNAR 


Default Japanese Lunar calendar 


15 


HSCAL CHINESE LUNAR 


Chinese Lunar calendar 


16 


HSCAL SAKA 


Indian Saka calendar 


17 


HSCAL LUNAR ETO CHN 


Chinese Zodiac calendar 


18 


HSCAL LUNAR ETO KOR 


Korean Zodiac calendar 


19 


HSCAL LUNAR ROKUYOU 


Japanese Lucky days calendar 



The /myCalendar/event/@advanceHijriValue (int minOccurs=0 maxOccurs=l) field is 
required for Hijri calendar support. @advanceHijriValue ranges fi-om {-3,-2,-1,1,2,3} and is 
added to the current date, but the day of the week stays the same. For example, if today is the 
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24th and @advanceHijriValue is set to be +2, then the user sees the date as being the 26th. 
Typically @advanceHijriValue is +/-1, and this suffices in most cases. Theoretically it can be 
any number, but the worst case scenario is H-/-3. 

The /myCalendar/event/@changeNumber (minOccurs=l maxOccurs=l) 
5 changeNiunber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/@id (minOccurs=l maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services 

Q 10 generates and assigns this ID during an insertRequest operation or possibly during a 

□ 

f U replaceRequest. Application software can override this ID generation by specifying the 

ru 
m 

S 

I- 



ry 



useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The /myCalendar/event/@creator (minOccurs=l maxOccurs=l) attribute identifies the 



1 5 creator in terms of userld, appid, and platformld of the node. 

Q 

The /myCalendar/event1)ody (minOccurs=l maxOccurs=l) includes the 
/myCalendar/event/body/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute, which is designed to facilitate caching of the element and its descendants. This 
attribute is assigned to this element by the .NET My Services system. The attribute is read 
20 only to applications. Attempts to vmte this attribute are silently ignored. 

The /myCalendar/event/body/cat (minOccurs=0 maxOccurs=unbounded) element is 
used to categorize the element that contains it by referencing either a global category 
definition (in either the .NET Categories service system document or an extemal resource 
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containing category definitions), or by referencing an identity-centered category definition in 
the content document of the .NET Categories service for a particular PUID. 

The /myCalendar/event/body/cat/@ref (anyURI minOccurs=l maxOccurs=l) attribute 
references a category definition (catDef) element using the rules outlined in the .NET 
5 Categories section, described above. 

The /myCalendar/event/body/title (string minOccurs=l maxOccurs=l) includes the 
/myCalendar/event/body/title/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766 (wherein ISO stands for Intemational Organization for Standardization and RFC stands 

C3 10 for Request For Comment). The value of this attribute indicates the language type of the 

P 

f U content within this element. The /myCalendar/event^ody/title/@dir (string minOccurs=0 



maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 



/myCalendar/event^ody/fullDescription/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myCalendar/event/body/fullDescription/@dir (string minOccurs=0 
20 maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The /myCalendar/event/body/location (string minOccurs=0 maxOccurs=l) optional 
element contains the event's location. The /myCalendar/event/body/location/@xml:lang 



C3 



The /myCalendar/event/body/fiillDescription (string minOccurs=0 maxOccurs=l) 




element contains a fi"ee form, full description of the event. The 
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(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/myCalendar/event/body/location/@dir (string minOccurs=0 maxOccurs=l) optional attribute 
5 specifies the default layout direction for the localized string. Valid values are rtl (right to left) 
and Itr (left to right). 

The /myCalendar/event/body/meetingStatus (string minOccurs=0 maxOccurs=l) 
tracks the status of this meeting {not-sent, sent, cancelled}. A regular appointment will not 
have this element. If <meetingStatus> exists, this event should be rendered as a meeting, not 
p 10 as an appointment. 

a 

ry The /myCalendar/event/body/recurrenceld (dateTime minOccurs=0 maxOccurs=l) 

recurrence id indicates the original start time of an occurrence of a recurring master , 

«p 

g appointment. It is required to identify what instance an exception is modifying, since users 

M 

O are allowed to change the start time on an orphan, (wherein an an exception is a modification 

ru 

W 1 5 of an instance and an orphan is an exception that is sent as a meeting request on its own). The 

13 

recurrenceld method is stored in UTC. It does not appear in the master schema, except in the 
specific case that an attendee is invited to an instance of a recurring event. Otherwise, 
<recurrenceld> is usually only a part of getCalendarDays. 

The /myCalendar/event1)ody/lastUpdateTime (dateTime minOccurs=0 maxOccurs=l) 
20 field is updated by the organizer whenever s/he creates and sends a new meeting request. This 
helps the attendee to identify which meeting request is the most recent one. It is stored in 
coordinated universal time (UTC). This property is not modifiable by clients and is assigned 
by the server on modification and by the sendMeetingRequest. 
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The /myCalendar/event/body/startTime (dateTime minOccurs=l maxOccurs=l) 
startTime method defines the start time of the event. An all-day event by convention starts at 



12:00:00 AM of the day of the event. This is stored in UTC. Maximum range is January 1, 



1 753 to December 3 1 , 9999 to an accuracy of 3 .33 miUiseconds. If this event is a recurring 



5 event, <startTime> defines the dateTime when the recurrence window starts. The recurring 



master does not have to be an instance of the recurring event itself. An event in March set to 



recur every April will only appear in April. 



The /myCalendar/event^ody/endTime (dateTime minOccurs=l maxOccurs=l) 



endTime method defines the end time of the event. An all-day event by convention ends at 

P 10 11 :59:59 PM of the ending day. This is stored in UTC. Maximum range is January 1, 1753 to 

O 

f U December 3 1 , 9999 to an accuracy of 3.33 milliseconds. The duration of the event is inferred 
fi-om endTime - startTime. 



g The /myCalendar/event/body/allDay (boolean minOccurs=0 maxOccurs=l ) element 

□ indicates a regular event by being false or being absent. Otherwise, this attribute indicates that 

ru 

fy 1 5 the event is an all-day event. All day events may span multiple days. By convention, all day 

5s =T 
E n 

events start at 12:00:00 am of the day of startTime, regardless of what time it actually is, and 



it will end at 1 1 :59:59 pm of the endTime date. In other words, if the allDay element is 



present and has value=true, .NET Calendar will ignore the actual times of the events and 



consider only the date part of the field. 



20 The allDay tag is meant to operate as a hint to UI renders to display speciaUzed icons 



indicating an all-day event. allDay events are distinguishable between 24-hr events starting at 



12am. In the case of a meeting request, an allDay event will not appear in the local user's 



time zone, but rather in the organizer's time zone. 
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The /myCalendar/event/body/floating (boolean minOccurs=0 maxOccurs=l) floating 
attribute indicates that this event is to occur in the current local time zone no matter what time 
zone the system is currently in (that is, it floats). For example, holidays are floating events. 
As another example, it may be useful to schedule medication regardless of an actual time 
zone, whereby a floating attribute is used with such an event. Floating values are stored as-is: 
no time-zone translations are needed to convert them to UTC or any local time zone. 

The /myCalendar/event/body/travelTimeTo (int minOccurs=0 maxOccurs=l) field 
contains the amount of time (in minutes) that it takes to travel to the meeting location. The 
/myCalenda^/event^ody/travelTimeFrom (int minOccurs=0 maxOccurs=l) field contains the 
□ 10 amount of time (in minutes) that it takes to retum from the meeting location. These optional 
elements show in free/busy calculations. 

The /myCalendar/event/body/freeBusyStatus (string minOccurs=0 maxOccurs=l) 
g"" optional element annotates the freeBusy behavior of this event. Events by default appear as 
tj "busy". The user may explicitly define this event to be armotated by setting .NET Calendar 

ru 

fU 1 5 values to free, tentative, busy or away. 

The /myCalendar/event/body/cuid (string minOccurs=0 maxOccurs=l) cuid 
(CorrelationUID) links an organizer's event to an attendee's event. It identifies which 
response from an attendee is for which request from an organizer, and which meeting request 
update from the organizer is for which previously accepted meeting by the attendee. The 
20 "cuid" is the same on both the attendee's and the organizer's copy of the appointment. It is 
also identical on the exception and the recurring master, wherein an exception is a 
modification of an instance. This value is assigned by the .NET Calendar server and is non- 
modifiable. 
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The /myCalendar/eventAjody/organizer (minOccurs=0 maxOccurs=l) field contains 
the email address of the event organizer. The /myCalendar/event^ody/organize^/name (string 
minOccurs=0 maxOccurs=l) optional element specifies tiie name for the enclosing element. 
The /myCalendar/event/body/organizer/name/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myCalendar/event^ody/organizer/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the locahzed string. 
VaUd values are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/body/organizer/puid (string minOccurs=0 maxOccurs=l) 
optional element specifies the PUID for the enclosing element. The 
/myCalendar/evenfbody/organizer/email (string minOccurs=0 maxOccurs=l) optional name 
specifies an e-mail address for the enclosing element. 

The /myCalendar/event/body/{any} (minOccurs=0 maxOccurs=unbounded) provides 

for additional body elements. 

The /myCalendar/event/attendeeEventExtra (minOccurs=0 maxOccurs=l) field 
contains additional information about an event, found only in an event invitee's schema. The 
/myCalendar/event/attendeeEventExtra/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The ZmyCalendar/event/attendeeEventExtra/intendedFreeBusy (string minOccurs=0 
maxOccurs=l) element is the event organizer's fi-eeBusy information and is thus equal to 
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event/freeBusyStatus. Invitees may overwrite event/freeBusyStatus with a new value, and 
intendedFreeBusy is intended to store the organizer's original freeBusyStatus. 

The ZmyCalendar/event/attendeeEventExtra/responseTime (dateTime minOccurs=0 
maxOccurs=l) field contains the rqjly time on each attendee is set to the current time (Now) 
5 when the organizer sends a meeting invitation. When the attendee responds, they update their 
responseTime. When the organizer receives responses, they will honor only those that have a 
higher responseTime than what is maintained in his/her own copy of the event for each 
attendee. While processing the response, tiie organizer will update their responseTime. This 
guarantees that the organizer honors only the most recent response from the attendee. This is 

H 

Q 10 stored in UTC. 

U 

The ZmyCalendar/event/attendeeEventExtra/responseType (string minOccurs=0 
\^ maxOccurs=l) accept status indicates the valid types of responses that an attendee can reply 
T with {accept, decline, tentative, counterpropose} . The absence of this field indicates that no 

b 

O response has been recorded. 

ru 

W 15 xhe /myCalendar/event/attendeeEventExtra/counterProposeStartTime (dateTime 

minOccurs=0 maxOccurs=l) field contains the counter proposal start time information. If 
responseType=[counterPropose], then either the startTime, endTime, or location, or all three 
can be present. This is the invitee's counterproposal for a new start time for the meeting. 
This is stored in UTC. 

20 The ZmyCalendar/event/attendeeEventExtra/counterProposeEndTime (dateTime 

minOccurs=0 maxOccurs=l) field contains the counter proposal end time information. If 
responseType=[counterProposei, then either the {startTime, endTime}, or location, or both 
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can be present. This is the invitee's counterproposal for a new end time for the meeting. This 
is stored in UTC. 

The /myCalendar/event/attendeeEventExtra/counterProposeLocation (string 
minOccurs=0 maxOccurs=l) field contains the counter proposal location information, field 
5 contains the counter proposal start time information. If responseType=[counterPropose], then 
either the {startTime, endTime}, or location, or both can be present. This is the invitee's 
counterproposal for a location for the meeting. 

The ZmyCalendar/event/attendeeEventExtra/responseBody (string minOccurs=0 
maxOccurs=l) field contains an optional message for invitees to include along with the 
Q 10 response. The/myCalendar/event/attendeeEventExtra/responseBody/@xml:lang 

(niinOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3 1 66 country code as described in RFC 1 766. The value of this attribute indicates 

c? - 

R 

g' the language type of the content within this element. The 

H 

C3 /myCalendar/event/attendeeEventExtra/responseBody/@dir (string minOccurs=0 

ru 

15 maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The ZmyCalendar/event/attendeeEventExtra/delegateResponder (minOccurs=0 
maxOccurs=l) field stores information of a delegate who responds on behalf of an invitee. 
The /myCalendar/event/attendeeEventExtra/delegateResponder/name (string minOccurs=0 

20 maxOccurs=l) optional element specifies the name for the enclosing element. The 

/myCalendar/event/attendeeEventExtra/delegateResponder/name/@xml:lang(minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
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type of the content within this element. The 

/myCalendar/event/attendeeEventExtra/delegateResponder/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the defauh layout direction for the localized string. 
Vahd values are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/attendeeEventExtra/delegateResponder/puid (string 
minOccurs=0 maxOccurs=l) optional element specifies the PUID for the enclosing element. 
The /myCalendar/event/attendeeEventExtra/delegateResponder/email (string minOccurs=0 
maxOccurs=l) optional name specifies an e-mail address for the enclosing element. The 
/myCalendar/event/attendeeEventExtra/ {any} (minOccurs=0 maxOccurs=unbounded) 
provides for additional attendee extra properties. 

The /myCalendar/event/attachment (minOccurs=0 maxOccurs=unbounded) element 
contains attachment metadata, name, content-type and id's, and may also contain the 
attachmentBody. The /myCalendar/event/attachment/@changeNiunber (minOccurs= 1 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/attachment/@id (minOccurs=l maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services generates and assigns this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 
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The /myCalendar/event/attachment/@creator (ininOccurs=l maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformld of the node. The 
/myCalendar/event/attachment/name (string minOccurs=l maxOccurs=l) element contains 
information about an individual attachment in a mail message. The 
/myCalendar/event/attachment/name/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myCalendar/event/attachment/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/attachment/contentType (string minOccurs=l maxOccurs=l) 
element contains the content type of the attachment. The 

/myCalendar/event/attachment/contentTransferEncoding (string minOccurs=l maxOccurs=l) 
element contains the encoding of the attachment. This information is necessary for decoding 
the attachment. The /myCalendar/event/attachment/size (unsignedLong minOccurs=l 
maxOccurs=l) element contains the size of the attachment in bytes. The 
/myCalendar/event/attachment/attachmentBody (base64Binary minOccurs=l maxOccurs=l) 
element contains the contents of the attachment. 

The /myCalendar/event/reminder (minOccurs=0 maxOccurs=l) is directed to 
reminders. A user may optionally define a reminder for this appointment. Reminders for 
recurring appointments will be sent periodically before the appointment, as per the rules 
defined in the reminder subschema below. A non-recurring event may define no reminders, 
define a reminder with <set> = "true" or define a reminder with <set> = "false". 
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A recurring meeting may have no reminders defined, or a recurring reminder defined 
with all instances receiving reminders. To define no reminders by default, but to define 
reminders for particular meeting instances in the exception body, a reminder <set> = "false" is 
created, and tumed on and/or modified for particular instances. To define a recurring 
reminder, but turn it off for particular meeting mstances, a reminder <set> = "true" is created, 
and tumed off for particular instances. 

If the event's reminder subschema is non-existent, yet the exception body has a 
reminder blob, then the exception reminder is ignored. An ahemative is to require this. 

The /myCalendar/event/reminder/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/reminder/@id (minOccurs=l maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The /myCalendar/event/reminder/@creator (minOccurs=l maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
/myCalendar/event/reminder/set (boolean minOccurs=l maxOccurs=l) field maintains a 
Boolean flag that indicates whether the reminder is active for this event. In most cases, this 
will be true, but in the case of a recurring appointment, this flag may defauh to true with 

-43- 




specific instances not to be reminded, or default to false, with specific instances to be 
reminded. 

The /myCalendar/event/reminder/to (string minOccurs=l maxOccurs=l) stores a 
fiiendly name that this reminder is being sent to. The 
5 /myCalendar/event/reminder/to/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. The /myCalendar/event/reminder/to/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values 

□ 10 are rtl (right to left) and Itr (left to nght). 

Q 

fU The /myCalendar/event/reminder/offset (int minOccurs=l maxOccurs=l) field 

specifies the offset, in minutes, of how long before the event the user should be reminded. 

cn 

Recommended values are set forth in the following table: 



Value 


Description 


5, 10, 20, 30, 45 


5,10, 20, 30, 45 minutes before the event 


60, 120, 180, 


1,2,3 hours before the event 


startTime - startDay 


The day of the event (reminder sent at 12:00am) 


startTime - (startDay - (1440 * 

X)) 


"x" days before the event (reminder sent at 12:00am '*x" 

days before) 



15 The /myCalendar/event/reminder/interruptability (int minOccurs=0 maxOccurs=l) 

optional element defines how interruptible this event is and it is used by notification routing 
software to make decisions about the relay and deferral of notifications that might occur while 
this meeting is active. The value contained in this element is a numeric value between one 
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and ten. Lx)w values represent a high cost of disruption, high values represent a low cost of 
disruption. 

The /myCalendar/event/reminder/lastSentTime (dateTime minOccurs=l 
maxOccurs=l) field is required by the reminder engine. The 
5 /myCalendar/event/reminder/nextTriggerTime (dateTime minOccurs=l maxOccurs=l) 
determines the next time to trigger reminder. 

The /myCalendar/event/attendee (minOccurs=0 maxOccurs=unbounded) includes the 
attendeeType, which contains the information about an attendee, including the display, email, 
puid, and the attendee's response. 

f3 10 The /myCalendar/event/attendee/@changeNumber (minOccurs=l maxOccurs=l) 

□ 

fU changeNumber attribute is designed to facilitate caching of the element and its descendants. 

rU This attribute is assigned to this element by the .NET My Services system. The attribute is 

CP 

""'^ read only to applications. Attempts to write this attribute are silently ignored. 

p The /myCalendar/event/attendee/@id (minOccurs=l maxOccurs=l) attribute is a 

Fa S 

lU 

f U 1 5 globally unique ID assigned to this element by .NET My Services. Normally, .NET My 

Services generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 
20 The /myCalendar/event/attendee/@creator (minOccurs=l maxOccurs=l) attribute 

identifies the creator in terms of userld, appid, and platformid of the node. The 
/myCalendar/event/attendee/name (string minOccurs=0 maxOccurs=l) optional element 
specifies the name for the enclosing element. The 
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/myCalendar/event/attendee/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute 
is used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. The /myCalendar/event/attendee/name/@dir (string minOccurs=0 maxOccurs= 1 ) 
5 optional attribute specifies the defauU layout direction for the localized string. VaUd values 
are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/attendee/puid (string minOccurs=0 maxOccurs=l) optional 
element specifies the PUID for the enclosing element. The /myCalendar/event/attendee/email 
(string minOccurs=0 maxOccurs=l) optional name specifies an e-mail address for the 
p 10 enclosing element. The /myCalendar/event/attendee/inviteType (string minOccurs=l 

s 

fU maxOccurs=l) is used by a meeting organizer to define the kind of invitee, e.g., as required, 
optional, or a resource (e.g., meeting room). 

The /myCalendar/event/attendee/responseTime (dateTime minOccurs=0 

□ maxOccurs=l) reply time on each attendee is set to the current time (Now) when the organizer 

fit 

ru 15 sends a meeting invitation. When the attendee responds, they update their responseTime. 

C3 

When the organizer receives responses, they will honor only those that have a higher 
responseTime than what s/he maintains in his/her own copy of the event for each attendee. 
While processing the response, the organizer will update their responseTime. This guarantees 
that the organizer honors only the most recent response fi-om the attendee. This is stored in 
20 UTC. 

The /myCalendar/event/attendee/counterProposeStartTime (dateTime minOccurs=0 
maxOccxirs=l) field contains the counter proposal start time information. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
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can be present. This is the invitee's counterproposal for a new start time for the meeting. 
This is stored in UTC. 

The /myCalendar/event/attendee/coxmterProposeEndTime (dateTime minOccurs=0 
maxOccurs=l) field contains the counter proposal end time information. If 
5 responseType=[coimterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new end time for the meeting. This 
is stored in UTC. 

The /myCalendar/event/attendee/counterProposeLocation (string minOccurs=0 
maxOccurs=l) field contains the counter proposal location information, field contains the 
f3 10 counter proposal start time information. If responseType=[counterPropose], then either the 

fU {startTime, endTime}, or location, or both can be present. This is the invitee's 

H 

f'U counterproposal for a location for the meeting. 

cn 

as 

y The /myCalendar/event/attendee/responseBody (string minOccurs=0 maxOccurs=l ) 

u 

£3 field contains an optional message for invitees to include along with the response. The 

fu 

fU 15 /myCalendar/event/attendee/responseBody/@xml:lang (minOccurs=l maxOccurs=l) required 

Q 

r'^ attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 

described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myCalendar/event/attendee/responseBody/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the base direction of directionally 
20 neutral text. Possible values include rtl (right to left) and Itr (left to right). 

The /myCalendar/event/attendee/{any} (minOccurs=0 maxOccurs=unbounded) allows 
for extensibihty. 
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The /myCalendar/event/recurrence (minOccurs=0 maxOcciirs=l) includes 
/myCalendar/event/recurrence/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute, designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/recurrence/rule (minOccurs=l maxOccurs=l) includes the 
/myCalendar/event/recurrence/rule/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute, designed to faciHtate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/recurrence/rule/creationDate (dateTime minOccurs=l 
maxOccurs=l) is required in order to exactly determine which timezone recurrence rule to 
use. The startTime of the event is not used because of the ability to create events in the past 
and in the future. 

The /myCalendar/event/recurrence/rule/firstDayOfWeek (string minOccurs=l 
maxOccurs=l) stores what the first day of the week (DOW) is for this user. Typical values 
are (su) Sunday or (mo) Monday. This maintains a recurrence rule's specified FirstDOW (for 
calculating the recurrence expansion. Allows recurring meetings to be expanded in the 
organizer's FirstDOW instead of the invitee's FirstDOW. 

The /myCalendar/event/recurrence/rule/tzid (int minOccurs=0 maxOccurs=l) 
identifies the time zone for this recurring event. The dateTime information in this event is 
stored m UTC (converted fi-om the local time zone defined by the time zone sub-schema). If 
this field is absent, the recurring event is assumed to be recurring in UTC time. However, it is 
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only a floating recurring event if the <floating> attribute is set, as described above. 
@afterDay is currently used, but is optional. 

The /myCalendar/event/recurrence/rule/isLeapYear (boolean minOccurs=0 
maxOccurs=l) provides International calendar support. It is possible to derive isLeapYear 
5 from leapMonthValue, but .NET Calendar stores both separately. The 

/myCalendar/event/recurrence/rule/leapMonthValue (int minOccurs=0 maxOccurs=l) 
<leapMonthValue> cannot be derived from a particular year and thus must be stored. For 
example, a user creates a recurrence on a Hebrew Lunar calendar. The year is a leap year and 
it has 13 months. In that year, the leapMonthValue is 7. 

M 

13 10 The /myCalendar/event/recurrence/rule/repeat (minOccurs=l maxOccurs=l) may 

O 

includes the /myCalendar/event/recurrence/rule/repeat/daily (minOccurs=0 maxOccurs= 1 ), 

fU 

ff| field, which specifies the number of days to repeat, e.g., repeat every [...] days. The 

e /myCalendar/event/recurrence/rule/repeat/daily/@dayFrequency (int minOccurs=l 

M 

P maxOccurs=l) specifies the periodicity of days over which repetition occurs, for example, 
15 repeat every 3 days. 

The /myCalendar/event/recurrence/rule/repeat/weekly (minOccurs=0 maxOccurs=l) 
field, if present, is directed to repeating weekly, e.g., repeat every [...] week(s) on 
{su,mo,tu,we,th,fr,sa} The presence of a weekday attribute means to repeat on this particular 
day. Any combination of the seven days is valid. 
20 The /myCalendar/event/recurrence/rule/repeat/weekly/@weekFrequency (int 

minOccurs=0 maxOccurs=l) repeat Weekly recurrence occurs every period of weeks. If the 
attribute is not present, it defaults to 1 (every week). 
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The /myCdendar/event/recurrence/rule/repeat/monthlyByDay (minOccurs=0 
maxOccurs=l) specifies to repeat on the [First, Second, Third, Fourth, Last] {su, mo, tu, we, 
th, fr, sa} of every [...] month(s). Any combination of the {weekday} attributes are valid, 
including user-defined combinations for weekdays and weekend days. 
5 The /myCalendar/event/recurrence/rule/repeat/monthlyByDay/@monthFrequency (int 

minOccurs=0 maxOccurs=l) specifies the month periodicity to recur on. If this attribute is 
not present, it defaults to 1 (every month). 

The/myCalendar/event/recurrence/mle/repeat/monthlyByDay/@weekdayOfMonth 

(string minOccurs=l maxOccurs=l) specifies which week in a month [first, second, third, 

C3 10 fourth, last]. 

C3 

j^^ The /myCalendar/event/recurrence/rule/repeat/monthly (minOccurs=0 maxOccurs=l) 

f ^ repeats the occurrence every month on a particular day. The very first occurrence is created 

s fi-om the parent event's startTime and endTime, but the recurrence occurs as follows: Repeat 

C3 every month on [day] of [month]. Repeat every [monthFrequency] month(s) on [day] of 

rs s 

ly 

% 15 [month]. Typically, the first occurrence is also an instance of the recurrence, but this need not 
be the case. 

The /myCalendar/event/recurrence/rule/repeat/monthly/@monthFrequency (int 
minOccurs=0 maxOccurs=l) optional attribute indicates the month periodicity. By default, it 
is 1, periodic every month. The start of the periodicity is determined firom event startTime. 
20 The /myCalendar/event/recurrence/rule/repeat/monthly/@day (int minOccurs^l 

maxOccurs=l) specifies the day of the month to recur on. Value is between one and 3 1 . 

A forceExact rule handles invaUd day-month combinations. The proper recurrence 
pattern for repeating on the last day of the month is to use repeatMonthlyByDay. "Repeat on 
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the [last] [day, weekday, weekend day] of...". By default, an invalid day-month combination 
will cause .NET Calendar to search backwards to find a valid day-month combination. If 
/myCalendar/event/recurrence/rule/repeat/monthly/@forceExact (boolean minOccurs=0 
maxOccurs=l) is true, an invahd starting [month ,day] combination such as [6, 31] is ignored 
5 and will not be included as an instance of the recurrence. With forceExact, day=31 will only 
pick up months that have 31 days, day=30 will pick up all months except February, day=29 
will pick up all months except February, except on leap years. February 29 is included on 
leap years. 

The /myCalendar/event/recurrence/rule/repeat/yearlyByDay (minOccurs=0 

u 

p 10 maxOccurs=l) specifies how to repeat on the [First, Second, Third, Fourth, Last] {su, mo, tu, 

□ 

f U we, th, fi-, sa} of [Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec] every 
[yearFrequency] years. 

y Any combination of the {weekday} attributes are valid, including user-defined 

□ combinations denoting weekdays and weekend days. This element's attributes contain 

ru 

fU 15 whether a given day is or is not considered by the user as part of the work week. If this 

P 

'-'^ element has no attributes, it is assumed that the user has a Monday to Friday work week. 

The /myCalendar/event/recurrence/rule/repeat/yearlyByDay/@yearFrequency (int 
minOccurs=0 maxOccurs=l) optional attribute indicates the year periodicity. By default, it is 
1 (repeat every year). 

20 The/myCalendar/event/recurrence/rule/repeat/yearlyByDay/@weekdayOfMonth 
(string minOccurs=l maxOccurs=l) Specifies which week in a month [first, second, third, 
fourth, last] to repeat. 
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The /myCalendar/event/recurrence/mle/repeat/yearlyByDay/@mont^ (int 
minOccurs=l maxOccurs=l) contains a value between one and thirteen (some calendars have 
thirteen months). 

The /myCalendar/event/recurrence/rule/repeat/yearly (minOccurs=0 maxOccurs=l) 
5 specifies to repeat every year on a particular date. The very first occurrence is created fi-om 
the parent event's startTime and endTime, but the recurrence occurs as follows: Repeat yearly 
on [day] of [month]. Repeat every [yearFrequency] years on [day] of [month]. Typically, the 
first occurrence is also an instance of the recurrence, but this need not be the case. 
The /myCalendar/event/recurrence/rule/repeat/yearly/@yearFrequency (int 

Q 10 minOccurs=0 maxOccurs=l) optional attribute indicates the year periodicity. By default, it is 

□ 

f y 1 (repeat every year). The /myCalendar/event/recurrence/rule/repeat/yearly/@month (int 

fU minOccurs=l maxOccurs=l) specifies the month to recur on. 

m 

The /myCalendar/event/recurrence/rule/repeat/yearly/@day (int minOccurs=l 

E 

p maxOccurs=l) specifies the day of the month to recur on. The value is between 1-31, and 

ru 

rU 15 forceExact, appUes for invalid day-month combinations. Thus, by default, an invalid day- 

b 

1=^ month-year combination will cause .NET Calendar to search backwards to fmd a valid day for 
a particular month, year. If /myCalendar/event/recurrence/rule/repeat/yearly/@forceExact 
(boolean minOccurs=0 maxOccurs=l) is true, an invalid starting [month ,day] combination 
such as [6, 3 1] is ignored and will not be included as an instance of the recurrence. With 
20 forceExact, .NET Calendar, day=3 1 will only pick up months that have 3 1 days, day=30 will 
pick up all months except February, day=29 will pick up all months except February, except 
on leap years. February 29 is included on leap years. 
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The /myCalendar/event/recurrence/rule/repeat/{aiiy} (minOccurs=0 
maxOccurs=unbounded) allows for any additional repeat rules. 

The /myCalendar/event/recurrence/rule/windowEnd (dateTime minOccurs=0 
maxOccurs=l) field indicates the end of the window over which the recurrence occurs. This 
5 is stored in UTC. The Maximum range is January 1, 1753 to December 31, 9999 to an 

accuracy of 3.33 milliseconds. Note that windowEnd, repeatForever, repeatlnstances may be 
selectable. 

The /myCalendar/event/recurrence/rule/repeatForever (boolean minOccurs=0 
maxOccurs=l) overrides the windowEnd date and specifies that this recurrence repeats 
^3 10 forever. Client implementations cannot depend on date values repeating forever, like 
[J 23:59:59pm Dec 31, 9999 or 23:59 Aug 31, 4500. 

§ ^ 

f p The /myCalendar/event/recurrence/rule/repeatlnstances (int minOccurs=0 

=& 

s maxOccurs=l) overrides the windowEnd date and specifies that this recurrence repeats for the 
specified number of instances. As is apparent, repeatlnstances and repeatForever are mutually 

fU 
fli 

U 15 exclusive, but repeatlnstances will override repeatForever for errant schemas. 

The /myCalendar/event/recurrence/rule/deletedExceptionDate (dateTime 
minOccurs=0 maxOccurs=unbounded) allows exceptions to a recurrence rule, which are 
added as an element list of dates. In general, the purpose of deletedExceptionDate is to 
prevent an instance/occurrence fi:om being generated during expansion of the series. The 
20 myCalendar service logic ignores the hh:mm:ss of the dateTime and merely blocks out the 
particular day. Any days can be added to an exception rule, including days where no 
occurrences of a recurrence rule would fall in the first place. This is stored in UTC. 
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The/myCalendar/event/recurrence/rule/{any} (minOccurs=0 maxOccurs=unbounded) 
provides for additional recurrence rule logic that cannot be expressed in .NET Calendar logic. 

The /myCalendar/event/recurrence/exception (minOccurs==0 maxOccurs=unbounded) 
field contains a list of modified event properties for this particular orphan event. The 
5 properties that are not modified are inherited fi-om the original event upon recurrence 
expansion (client-side). A recurrenceld is always present, and is used to determine which 
instance of the original rule this modifiedException appUes to. 

The /myCalendar/event/recurrence/exception/@changeNumber (minOccurs=l 
maxOccurs=l) changeNiunber attribute is designed to facilitate caching of the element and its 

P 10 descendants. This attribute is assigned to this element by the .NET My Services system. The 

u 

fU attribute is read only to applications. Attempts to write this attribute are silently ignored. 

It 

The /myCalendar/event/recurrence/exception/@id (minOccurs=l maxOccurs=l) 
attribute is a globally unique ID assigned to this element by .NET My Services. Normally, 

B 

p .NET My Services generates and assigns this ID during an insertRequest operation or possibly 

ry 

fU 15 during a replaceRequest. Application software can override this ID generation by specifying 

□ 

1^=^ the useClientlds attribute in the request message. After an ID has been assigned, the attribute 
is read only and attempts to write it are silently ignored. 

The /myCalendar/event/recurrence/exception/@creator (minOccurs=l maxOccurs=l) 
attribute identifies the creator in terms of userld, appid, and platformid of the node. The 
20 /myCalendar/event/recurrence/exception/recurrenceld (dateTime minOccurs=l maxOccurs=l) 
field contains the original start time (recurrenceld) of the occurrence that is being modified by 
this exception. ModifiedExceptions with recurrencelds that do not match the recurrenceld of 
any occurrence are ignored. This is stored in UTC. Note that modifiedException does not 
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expose the id attribute; the recurrenceld should be used to predicate instead, as it functions as 
the id of modifiedException. 

The /myCalenda^/event/^ecu^^ence/exception^ody (minOcciu^=0 maxOccurs=l) field 
contains the modifiable properties of the eventBody. The 
5 /myCalendar/event/recurrence/exception/body/title (string minOccurs=0 maxOccurs=l) 
allows for title changes. The /myCalendar/event/recurrence/exception^ody/title/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

□ 10 /myCalendar/event/recurrence/exception/body/title/@dir (string minOccurs=0 maxOccurs=l) 

il 

;^ optional attribute specifies the default layout direction for the localized string. Valid values 
fjl are rtl (right to left) and Itr (left to right). 

B The /myCalendar/event/recurrence/exception^ody/filllDescription (string 

Q minOccurs=0 maxOccurs=l) provides for a a revised description. The 

15 /myCalendar/event/recurrence/exception^ody/fiillDescription/@xml:lang (minOccurs=l 

maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3 166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myCalendar/event/recurrence/exception/body/fiilIDescription/@dir (string minOccurs=0 
20 maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exception/body/location (string minOccurs=0 
maxOccurs=l) allows for a meeting location to be switched, for this instance only (not 
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recurring instances). The /nlyCalenda^/event/recu^rence/exception^ody/location/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 
/myCalendar/event/recurrence/exception^ody/location/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the locaHzed string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exception/body/startTime (dateTime minOccurs==0 
maxOccurs=l), if present, switches the start time, again for this instance only. The 
/myCalendar/event/recurrence/exception/body/endTime (dateTime minOccurs=0 
maxOccxirs=l) switches the end time for this instance only. 

The /myCalendar/event/recurrence/exception/body/allDay (boolean minOccurs=0 
maxOccurs=l) specifies that this particular instance is allDay. The 

/myCalendar/event/recurrence/exception^ody/travelTimeTo (int minOccurs=0 maxOccurs=l) 
can adjust the travel to time for this instance, such as if traffic is a problem. The 
/myCalendar/event/recurrence/exception/body/travelTimeFrom (int minOccurs=0 
maxOccurs=l) can adjust the travel from time for this instance. 

The /myCalendar/event/recurrence/exception/body/freeBusyStatus (string 
minOccurs=0 maxOccurs=l) handles a priority is changed for this meeting instance. 

The /myCalenda^/event/recurrence/exception^ody/organizer (minOccurs=0 
maxOccurs=l) field will be present when the original organizer is replaced by another 
organizer. 
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The /myCalenda^/event/^ecu^rence/excq)tion^ody/o^ganize^/name (string 
minOccurs=0 maxOcciirs=l) optional element specifies the name for the enclosing element. 
The /myCalenda^/event/^ecu^rence/exception^ody/o^ganizer/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
5 country code as described in RFC 1 766. The value of this attribute indicates the language 
type of the content within this element. The 

/myCalendar/event/recurrence/exception^ody/organizer/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

In 

p 10 The /myCalendar/event/recurrence/exception/body/organizer/puid (string 

3 

ry minOccurs=0 maxOccurs=l) optional element specifies the PUK) for the enclosing element. 

M 

ru The /myCalendar/event/recurrence/exception/body/organizer/email (string minOccurs=0 

CO 

maxOccurs=l) optional name specifies an e-mail address for the enclosing element. The 

Q /myCalendar/event/recurrence/exception/attendeeEventExtra (minOccurs=0 maxOccurs=l) 

ru 

fU 15 provides for additional information about an event, found only in an event invitee's schema. 

P 

M The/myCalendar/event/recurrence/exception/attendeeEventExtra/intendedFreeBusy 
(string minOccurs=0 maxOccurs=l) intendedFreeBusy element is the event organizer's 
freeBusy information, and is thus equal to event/freeBusyStatus. Invitees may overwrite 
event/freeBusyStatus with a new value, and intendedFreeBusy is intended to store the 
20 organizer's original freeBusyStatus. 

The/myCalendar/event/recurrence/exception/attendeeEventExtra/responseTime 
(dateTmie niinOccurs=0 maxOccurs=l) reply time on each attendee is set to the current time 
(Now) when the organizer sends a meeting invitation. When the attendee responds, they 
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update their responseTime. When the organizer receives responses, they will honor only those 
that have a higher responseTime than what is maintained in his/her own copy of the event for 
each attendee. While processing the response, the organizer will update their responseTime. 
This guarantees that the organizer honors only the most recent response from the attendee. 
5 This is stored in UTC. 

The ZmyCalendar/event/recurrence/exception/attendeeEventExtra/responseType (string 
minOccurs=0 maxOccurs=l) accept status indicates the valid types of responses that an 
attendee can reply with {accept, decline, tentative, counterpropose}. The absence of this field 
indicates that no response has been recorded. 

QlO The 

C3 

fU /myCalendar/event/recurrence/exception/attendeeEventExtra/counterProposeStartTime 

If 

(dateTime minOccurs=0 maxOccurs=l) field contains the counter proposal start time 
information. If responseType=[counterPropose], then either the {startTime, endTime}, or 
p location, or both can be present. This is the invitee's counterproposal for a new start time for 

ru 

fU 15 the meeting. This is stored in UTC. 

Q 

The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/counterProposeEndTime 
(dateTime minOccurs=0 maxOccurs=l) field contains the counter proposal end time 
information. If responseType=[counterPropose], then either the {startTime, endTime}, or 
20 location, or both can be present. This is the invitee's counterproposal for a new end time for 
the meeting. This is stored in UTC. 
The 

ZmyCalendar/event/recurrence/exception/attendeeEventExtra/counterProposeLocation (string 
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minOcciirs=0 maxOccurs=l) field contains the counter proposal location information, field 
contains the counterproposal start time information. If responseType=[coimterPropose], then 
either the {startTime, endTime}, or location, or both can be present. This is the invitee's 
counterproposal for a location for the meeting. 
5 The/myCalendar/event/reciirrence/exception/attendeeEventExtra/responseBody 

(string minOccurs=0 maxOccurs=l) field contains an optional message for invitees to include 
along with the response. The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/responseBody/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 

f« 10 or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 

□ 

fU the language type of the content within this element. The 

\^ 

fU /myCalendar/event/recurrence/exception/attendeeEventExtra/responseBody/@dir (string 

m 

"'^ minOccurs=0 maxOccurs=l) optional attribute specifies the base direction of directionally 

s 

p neutral text. Possible values include rtl (right to left) and Itr (left to right). 

fu 

fU 15 The ZmyCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder 

C3 

(minOccurs=0 maxOccurs=l), when present,is for a delegate who responds on behalf of an 
invitee; the delegate will have their information stored here. 
The 

ZmyCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/name (string 
20 minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing element. 
The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/name/@xml: 
lang (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language 
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code or an ISO 3166 country code as described in RFC 1766. The value of this attribute 
indicates the language type of the content within this element. The 
ZmyCalendar/event/recun-ence/exception/attendeeEventExtra/delegateResponder/name/^ 
(string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
5 the localized string. Valid values are rtl (right to left) and Itr (left to right). 
The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/puid (string 
minOccurs=0 maxOccurs=l) optional element specifies the PUID for the enclosing element. 
The/myCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/email 
!J 10 (string minOccurs=0 maxOccurs=l) optional name specifies an e-mail address for the 



enclosing element. 

The /myCalendar/event/recurrence/exception/attendeeEventExtra/{any} (minOccurs=0 
maxOccurs==unbounded) allows for additional attendee extra properties. 

It. The meeting organizer of a recurring meeting may wish to exclude a particular 



c 

ry 

In 



C3 



ru 

fy 15 attendee for an instance of the meeting. This idRefType (puid) indicates which attendee, 



[3 



(firom the list of attendees at the event level) are not invited to this particular meeting instance, 
as specified in /myCalendar/event/recurrence/exception/deletedAttendee (string minOccurs=0 
maxOccurs=unbounded). The /myCalendar/event/recurrence/exception/deletedAttachment 
(string minOccurs=0 maxOccurs=unbounded) is used when the meeting organizer of a 
20 recurring meeting may wish to exclude a particular attachment for an instance of the meeting. 
The /myCalendar/event/recurrence/exception/attachment (minOccurs=0 
maxOccurs=unbounded) specifies the scheme the message contents were encoded in. 
Examples of this are '7bit', '8bit' and 'base64'. 
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The /myCalendar/event/recuiTence/excq)tion/attachment/naine (string minOccurs=l 
maxOccurs=l) element contains information about an individual attachment in a mail 
message. The /myCalendar/event/reciirrence/exception/attachment/name/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
5 or an ISO 3 166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/myCalendar/event/recurrence/exception/attachment/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 
1 0 The /myCalendar/event/recurrence/exception/attachment/contentType (string 

C3 

fU minOccurs=l maxOccurs=l) element contains the content type of the attachment. 

fU The/myCalendar/event/recurrence/exception/attachment/contentTransferEncoding 

m 

*N (string minOccurs=l maxOccurs=l) element contains the encoding of the attachment. This 

s 

mformation is necessary for decoding the attachment. 

ru 

ru 1 5 The /myCalendar/event/recurrence/exception/attachment/size (unsignedLong 

P 

minOccurs=l maxOccurs=l) element contains the size of the attachment in bytes. 

The/myCalendar/event/recurrence/exception/attachment/attachmentBody 
(base64Binary minOccurs=l maxOccurs=l) element contains the contents of the attachment. 
The /myCalendar/event/recurrence/exception/attendee (minOccurs=0 
20 maxOccurs=unbounded) attendeeType contains the information about an attendee, including 
the display, email, puid, and the attendee's response. 

The /myCalendar/event/recurrence/exception/attendee/name (string minOccurs=0 
maxOccurs=l) optional element specifies the name for the enclosing element. The 
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/myCalendar/event/reciirrence/exception/attendee/name/@xml:la^ 

maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myCalendar/event/recurrence/exception/attendee/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exception/attendee/puid (string minOccurs=0 
maxOccurs=l) optional element specifies the PUID for the enclosing element. 

The /myCalendar/event/recurrence/exception/attendee/email (string minOccurs=0 
maxOccurs=l) optional name specifies an e-mail address for the enclosing element. 

The /myCalendar/event/recurrence/exception/attendee/inviteType (string minOccurs=l 
maxOccurs=l) is used by the meeting organizer to define the kind of invitee {required, 
optional, resource} . 

The /myCalendar/event/recurrence/exception/attendee/responseTime (dateTime 
minOccurs=0 maxOccurs=l) is for the reply time. The reply time on each attendee is set to 
the current time (Now) when the organizer sends a meeting invitation. When the attendee 
responds, they always update their responseTime. When the organizer receives responses, 
they will honor only those that have a higher responseTime than what s/he maintains in 
his/her own copy of the event for each attendee. While processing the response, the organizer 
will update their responseTime. This guarantees that the organizer honors only the most 
recent response fi^om the attendee. This is stored in UTC. 

The /myCalendar/event/recurrence/exception/attendee/responseType (string 
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minOccurs=0 maxOccurs=l) accept status indicates the valid types of responses that an 
attendee can reply with {accept, decline, tentative, counterpropose}. The absence of this field 
indicates that no response has been recorded (either the invitation has not been sent, or that a 
reply has not been received). 

The/myCalendar/event/recurrence/exception/attendee/counterProposeStartTime 
(dateTime minOccurs=0 maxOccurs=l) is Uke other counter proposal data. Thus, If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new start time for the meeting. 
This is stored in UTC. The 

/myCalendar/event/recurrence/exception/attendee/counterProposeEndTime (dateTime 
minOccurs=0 maxOccurs=l) is for the counter-proposed end time, and if 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new end time for the meeting. This 
is stored in UTC. The 

/myCalendar/event/recurrence/exception/attendee/counterProposeLocation (string 
minOccurs=0 maxOccurs=l) field is for the counter-proposed location. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a location for the meeting. 

The /myCalendar/event/recurrence/exception/attendee/responseBody (string 
minOccurs=0 maxOccurs=l) provides for an optional message for invitees to include along 
with the response. The 

/myCalendar/event/recurrence/exception/attendee/responseBody/@xml:lang(minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
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country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myCalendar/event/recurrence/exception/attendee/responseBody/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exception/attendee/{any} (minOccurs=0 
maxOccurs=unbounded) field provides extensibility. 

The /myCalendar/event/recurrence/exception/reminder (minOccurs=0 maxOccurs=l) 
are the properties of the reminder that may be modified. If there is no reminder subschema in 
C3 10 the event body, exception reminders are ignored. 

The /myCalendar/event/recurrence/exception/reminder/set (boolean minOccurs=0 
maxOccurs=l), /myCalendar/event/recurrence/exception/reminder/offset (int minOccurs=0 
maxOccurs=l) and /myCalendar/event/recurrence/exception/reminder/interruptability (int 

C3 minOccurs=0 maxOccurs=l), are generally as described above, however note that these fields 

m 

S TT 

15 are for exceptions. 



ru 
I* 
ry 
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The /myCalendar/event/recurrence/exception/{any} (minOccurs=0 
maxOccurs=unbounded) provides for additional properties of the myCalendar/BaseEventType 
schema. 

The /myCalendar/event/recurrence/{any} (minOccurs=0 maxOccurs=unbounded) 
20 provides for additional recurrence rule elements. 

The /myCalendar/subscription (minOccurs=0 maxOccurs=unbounded) element defines 
a subscription node as described above in the subscription section. 



-64- 



The myCalendar content document include a subscription node that essentially takes 
action when items change, such as to propagate infomiation about the change to other 
services. 

The /myCalendar/subscription (minOccurs=0 maxOccurs=unbounded) element defines 
a subscription node that is designed to be an xdb:blue node which when placed in a content 
document causes a subscription to be registered, (wherein as used herein, the string 
"myCalendar" referred to in this section can be replaced by an appropriate service name, e.g., 
"myApplicationSettings" or "myCalendar" or "myWallet" and so forth). A subscription 
contains a trigger element which selects a scope of coverage. When items that are under this 
scope of coverage change, a subscriptionResponse message is generated and sent to the 
specified destination address. 

The /myCalendar/subscription/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system, and the attribute is 
read-only to applications; attempts to write this attribute are silently ignored. 
The /myCalendar/subscription/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myCalendar/subscription/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
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/myCalendar/subscription/trigger (minOccurs=l maxOccurs=l) includes the 
/myCalendar/subscription/trigger/@select (string minOccurs=0 maxOccurs=l) item, which 
specifies an XPATH expression that specifies the nodes that are to be selected and watched 
for changes. The selection may only select xdb:blue nodes, as described above. A s changes 
5 in this node set occur, they trigger the generation of a subscription message. These messages 
are then sent to the SOAP receiver listed in the "to" element. 

The /myCalendar/subscription/trigger/@mode (string minOccurs=0 maxOccurs=l) 
attribute specifies whether or not the content of the changes that triggered the subscription are 
delivered in the subscription message, or if the message simply indicates that something 

£310 changed xmder the trigger. The attribute may comprise includeData, namely that the data that 

□ 

changed and caused the subscription to trigger is included in the subscription message. Note 
that deleted nodes are specified by their id, not by value. Alternatively the attribute may 

g comprise excludeData, whereby the data that changed, causing the subscription to trigger, is 

Q not included in the subscription message. 

ru 

15 The /myCalendar/subscription/trigger/@baseChangeNimiber (minOccurs=0 

C3 

maxOccurs=l) attribute specifies the changeNumber value that the trigger is relative to. All 
changes between the specified change number, and the current state of the document relative 
to the selection are transmitted as subscription messages. This allows a client application to 
establish a subscription relative to some baseline. As in changeQuery, if the 
20 baseChangeNumber is way out of date relative to the current state of the docvmient, and the 
service can not supply the changes in the subscription message, the subscription insert is 
rejected. A value of zero (0) means that the current values of the selected nodes are 
transmitted in the subscription message. 

-66- 



The /myCalendar/subscription/expiresAt (dateTime minOccurs=0 maxOccurs=l) 
optional element specifies an absolute time after which the subscription is no longer active. 
The subscription node is automatically removed when the subscription expires. If this 
element is missing, the subscription does not expire. The /myCalendar/subscription/context 
5 (minOccurs=l maxOccurs=l) element retums the context element fi-om the original 

subscription. Applications should use this element to correlate the subscription response with 
one of their subscriptions. 

The /myCalendar/subscription/context/@uri (anyURI minOccurs=0 maxOccurs=l) 
attribute specifies the URI value chosen by the subscriber that is associated with this 

f3 10 subscription. The /myCalendar/subscription/context/{any} (minOccurs=0 

C3 

fU maxOccurs=unbounded) including the /myCalendar/subscription/to (anyURI minOccurs=l 

maxOccurs=l) attribute specifies the location that is to receive the subscription message. The 
]^ value of this element may be hs:myAlerts, whereby this URI indicates that generated 
Q subscription messages are to be dehvered inside the body of a notification and delivered to the 

ru 

f U 1 5 default .NET Alerts service of the creator. AUematively, the value may be protocol://service, 

O 

whereby this URI indicates that generated subscription messages are delivered to the specified 
service at the domain of the creator's platformld. For example, a platformid indicating 
microsoft.com, and a value in this element of http://subscriptionResponse would cause 
delivery of the subscription message to http://subscriptionResponse.microsoft.com. If this 
20 value is not specified, then the subscription message is delivered as a notification to the 
"creator's" .NET Alerts service. The /myCalendar/{any} (minOccurs=0 
maxOccurs=unbounded) field allows for extensibility. 
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MvCalendar / System 

The system document is a global document for each service, having content and 
meaning that is independent of the puid used to address the service. The document is read 
only to all users. Each system document contains a set of base items common to each of the 
.NET My Services described herein, and is optionally extended by each service to include 
service-specific global information. The following schema outline illustrates the layout and 
meaning of the information found in the myCalendar system document: 
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TABLE - /*actual service name*/ system 

<sys:svstem chaDgeNumber= " ..." instanceld=" ..." 
xmlns:hs=" http.7/schemas.microsoft.com/hs/200 1/1 0/core" 

xmlns:sys=" http://schemas.microsoft.coin/hs/2001/10The /*actual service name*/system" >i i 
<hs:system Version changeNumber= " ..." id=" ..." creator =" ..." >, , 
<hs:versionmajorVersion=" ..." minorVersion=" ..." buildNumber=" ..." qfe=" ..." >,..i 
<hs:productReleaseName>i..,</hs:productReleaseName> 

<hs:productImplementationName>i.j</hs:productImplementationName> 

</hs:version> 

<hs:buildDate>i..i</hs:buildDate> 

<hs:buiIdDetails machine=" ..." branch=" ..." type=" ..." official=" ..." >,..,</hs:buildDetails> 
</hs : system Version> 

<hs:roleMap changeNumber =" ..." id=" ..." creator=" ...">,.., 

<hs:SC0pe id=" ..." >o..unbounded 

<hs:name xml:lang=" ..." dir=" ..." >o..unbounded</hs:name> 
<hs:shape base=" ..." >,.., 

<hs:include select=" ..." >o..unbounded</hs:include> 

<hs:exclude select=" ..." >o..unbounded</hs:exclude> 
</hs:shape> 
</hs:scope> 

<hs:roleTemplate name=" ..." priority=" ..." >o..urfx,«nded 
<hs:fullDescription xml:lang=" ..." dir=" ..." >o..i</hs:fixllDescription> 
<hs:method name=" ..." scopeRef^" ..." >o..unbounded</hs:method> 

</hs:roleTemplate> 
</hs:roleMap> 

<hs:methodMap changeNumber=" ..." id=" ..." creator^ " ..." >. , 

<hs:method name=" ..." >o..unboundcd /a/iJ!/</hs:method> 
</hs : metho dMap> 

<hs:scliemaMap changeNumber =" ..." id=" ..." creator=" ..." >i .i 

<hs:schemanamespace=" ..." schemaLocation=" ..." alias=" ..." >o..unbounded /a/ij^;</hs:schema> 
</hs:schemaMap> 

<hs:wsdIMap changeNumber-' ..." id=" ..." creator= " ..." >» i 

<hs:wsdl wsdlLocation=" ..." >o..unbounded /fl/i>:/</hs:wsdl> 

<hs:disco discoLocation=" ..." >o..uiibounded /fl/iJ!/</hs:disco> 

<hs:wsil wsilLocation=" ..." >a.unboundcd {any}</hs:v/sil> 
</hs:wsdlMap> 
</any> 

<ysys:system> 



The meaning of the attributes and elements shown in the preceding sample document 
outline follow, beginning with /system (minOccurs=l maxOccurs=l), the element that 
encapsulates a system document common to the various services. Although each service has 
its own system document, the common system document attributes and elements are described 
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once, for purposes of simplicity, with service-specific system document attributes and 
elements specified for each service, below. The /system/@changeNumber (minOccurs=0 
maxOccurs=l) attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /system/@instanceld (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service. 

The /system/systemVersion (minOccurs=l maxOccurs=l) element defines version 
information describing this instance of the .NET MyServices service. The 
/system Version/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber attribute is 
designed to faciUtate caching of the element and its descendants. This attribute is assigned to 
this element by the .NET My Services system. The attribute is read-only to applications; 
attempts to write this attribute are silently ignored, (e.g., without generating an error). 

The /system/system Version/@id (mmOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClienflds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /system/systemVersion/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformld of the node. The 
/system/systemVersion/version (minOccurs=l maxOccurs=l) element defines major, minor, 
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and build number version information. The /system/system Version/veision/@majorVersion 
(string minOccurs=0 maxOccurs=l) attribute specifies the major version number of the .NET 
MyServices service. 

The /system/systemVersion/version/@minorVersion (string minOccurs=0 
5 maxOccurs=l ) attribute specifies the minor version number of the .NET MyServices service. 
The /system/system Version/version/@buildNumber (string minOccurs=0 maxOccurs=l) 
attribute specifies the buildNumber of the .NET MyServices service. The 
/systeni/systemVersion/version/@qfe (string minOccurs=0 maxOccurs=l) attribute specifies 
the qfe version number of the .NET MyServices service. The 

□ 10 /system/system Version/version/productReleaseName (string minOccurs=l maxOccurs=l) 

O 

f y element defmes the major product release string (as in .NET My Services Beta 1 , and so on). 
j| The /system/system Version/version/productlmplementationName (anyURI minOccurs=l 
maxOccurs=l) element defines the class of the service to dififwentiate between different 



element defines the date and time that the .NET My Services system was built. The time is in 
UTC (Z relative) form. The /system Version/buildDetails (minOccurs=l maxOccurs=l) 
element defines details of the build including the machine that generated the build, the branch 
id of the software that contributed to the build, the type of build (chk/fi-e), and if the build was 
20 generated by an official build release process. 

The /system/system Version/buildDetails/@machine (string minOccurs=0 
maxC)ccurs=l) attribute specifies the machine that generated the build. The 
system/system Version/buildDetails/@branch (string minOccurs=0 maxOccurs=l) attribute 




implementations. 



The /system/systemVersion/buildDate (dateTime niinOccurs=l maxOccurs=l) 
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specifies the software branch id for the source code that contributed to this build. The 
/syste^l/systemVersion^uildDetails/@type (string minOccurs=0 maxOccurs=l) attribute 
specifies the type of build. A value of chk indicates that this is a checked or debug build. A 
value of fi^e indicates that this is a retail build. The 
5 /system/systemVersion/buildDetails/@ofiBcial (string minOccurs=0 maxOccurs=l) attribute 
indicates that the build was produced by an official build process (value of yes), or an 
unofGcial process (value of no). 

The /system/roleMap (minOccurs=l maxOccurs=l) element encapsulates all the 
elements that make up a roleMap, which include document class relative roleTemplate, 

-= 

Q 10 priority, name, method, and per-method scope. An individual roleTemplate defines the 

C3 

f U maximum scope of information, and the allowable methods used to access that information 

fU for each request mapped into the template. The /system/roleMap/@changeNumber 

'J^ (minOccurs=0 maxOccurs=l ) changeNumber attribute is designed to facilitate caching of the 

p element and its descendants. This attribute is assigned to this element by the .NET My 

rii 

rU 15 Services system. The attribute is read-only to applications. Attempts to write this attribute 
are silently ignored. The /system/roleMap/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
20 useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /system/roleMjq)/@creator (string niinOccurs=0 maxOccurs=l) attribute identifies 
the creator in terms of userld, appid, and platformid of the node. The /system/roleMap/scope 
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(minOccurs=0 maxOccurs=unbounded) element defines a scope which may be refeired to by 
roles within this roleMap to indicate what portions of the document are visible to this role for 
the specified method. 

The /system/roleMap/scope/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
5 unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. The /system/roleMap/scope/name (string 

p 10 minOccurs=0 maxOccurs=unbounded) node includes the 

p 

rU /system/roleMap/scope/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute, 
W which is used to specify an ISO 639 language code or an ISO 3 1 66 country code as described 
in RFC 1 766. The value of this attribute indicates the language type of the content within this 
p element. The /system/roleMap/scope/name/@dir (string minOccurs=0 maxOccurs=l) 

ru 

rU 15 optional attribute specifies the default layout direction for the localized string. Valid values 
•-•^ are rtl (right to left), and Itr (left to right). 

The /system/roleMap/scope/shape (minOccurs=l maxOccurs=l) comprises a sh^e 
that defmes the node set that is visible through the document when operating through this 
shape element. The /system/roleMap/scope/shape/@base (string minOccurs=0 maxOccurs=l) 
20 attribute specifies the initial set of nodes visible through the shape. A value oft indicates that 
the shape is initialized to include all possible nodes relative to the shape that is currently in 
effect. For instance, each role defines a scope containing a shape. When defining a shape for 
a role, the value t indicates all possible nodes available in the specified document for this role. 
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When defining a shape in an ACL entry, a value of t means all of the nodes visible in the 
shape for the computed role. When using a shape in a data language (e.g., query, insert, 
replace and so on) operation, a value of t indicates all of the possible nodes selected by the 
data language operation (relative to the ACL shape which itself is relative to the role's shape). 
The value nil indicates the opposite of t, which is the empty node set. Nodes fi-om this set 
may then be included into the shape. 

The /system/roleMap/scope/shape/include (minOccurs=0 maxOcciu-s=unbounded) 
element specifies the set of nodes that should be included into the shape relative to the 
possible set of nodes indicated by the base attribute. The 

/system/roleMap/scope/shape/include/@select (string minOccurs=0 maxOccurs=l) item 
specifies an XPATH expression that selects a set of nodes relative to the externally 
established context. The expression can never travel outside the node-set established by this 
extemally established current context. The expression may match zero or more nodes, and the 
operation manipulates all selected nodes. The minOccurs and maxOccurs attributes are 
optional and place restrictions and limitations on the number of nodes selected. 

The /system/roleMap/scope/shape/exclude (minOccurs=0 maxOccurs=unbounded) 
element specifies the set of nodes that should be excluded fi-om the shape relative to the 
possible set of nodes indicated by the base attribute. The 

/system/roleMap/scope/shape/exclude/@select (string minOccurs=0 maxOccurs=l) item 
specifies an XPATH expression that selects a set of nodes relative to the extemally 
estabhshed context. The expression can never travel outside the node-set established by this 
extemally established current context. The expression may match zero (0) or more nodes, and 
the operation manipulates all selected nodes. The minOccurs and maxOccurs attributes are 
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optional and place restrictions and limitations on the number of nodes selected. The 
/system/roleMap/roleTemplate (minOccurs=0 maxOccurs=unbounded) element encapsulates 
the definition of a role. The attribute set for this element includes the document class that this 
roleTemplate refers to, the name of the roleTemplate, and the priority of the roleTemplate. 
5 The /system/roleMap/roleTemplate/@name (string minOccurs=0 maxOccurs=l) 

element specifies the name of the role. The /system/roleMap/roleTemplate/@priority (int 
minOccurs=0 maxOccurs=l) element specifies the priority of the roleTemplate which is used 
to select that actual roleTemplate when the role evaluation determines that the subject maps to 
multiple roleTemplates. 

O 10 The /system/roleMap/roleTemplate/fiillDescription (string minOccurs=0 

P maxOccurs=l) element contains a description of this role template which specifies the 

rU 

p capabilities a caller will have when accessing information through this role. The 

R 
s'ftt 

= /system/roleMap/roleTemplate/fiillDescription/@xml:lang (minOccurs=l maxOccurs=l) 

H 

O required attribute is used to specify an ISO 639 language code or an ISO 3 1 66 country code as 

15 described in RFC 1766. The value of this attribute indicates the language type of the content 
S ... 

within this element. The /system/roleMap/roleTemplate/fullDescription/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /system/roleMap/roleTemplate/method (minOccurs=0 maxOccurs=unbounded) 
20 element specifies the methods available within this roleTemplate by name, and by scope. 
When a subject maps to a roleTemplate, the method in the request must match one of these 
elements for the message to continue to flow. If the method exists, the data available to the 
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method is a function of the scope referenced by this method combined with an optional scope 
referenced by the role defined in the roleList. 

The /system/roleMap/roleTemplate/method/@name (string minOccurs=0 
maxOccurs^l) element specifies the name of the method. The 
5 /system/roleMap/roleTemplate/method/@scopeRef (string minOccurs=0 maxOccurs=l) 
attribute specifies the scope within this document that is in effect for this method. The 
/system/methodMap (minOccurs=l maxOccurs=l) element defines the methodMap. While in 
most cases, the roleMap section contains a definitive list of methods, these methods are likely 
to be scattered about the roleMap in various templates. This section contains the definitive 

□ 10 non-dupHcated list of methods available within the service. 

O 

The /systeni/methodMap/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
"J" This attribute is assigned to this element by the .NET My Services system. The attiibute is 
Q read-only to applications. Attempts to write this attiibute are silently ignored. 
^ 1 5 The /system/methodMap/@id (minOccurs=0 maxOccurs=l) attiibute is a globally 

umque ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attiibute in the request message. Once an ID is assigned, the attribute is read- 
20 only and attempts to write it are silently ignored. The /system/methodMap/@creator (stiing 
minOccurs=0 maxOccurs=l) attiibute identifies the creator in terms of userld, appid, and 
platformid of the node. 
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The /system/methodMap/method (minOccurs=0 maxOccurs=unbounded) element 
defines a method that is available within this service. The 

/system/methodMap/method/@name (string minOccurs=0 maxOccurs=l) attribute specifies 
the name of a method available within the service. The /system/methodMap/method/ {any} 
(minOccurs=0 maxOccurs=unbounded) provides for extensibility. The /system/schemaMap 
(minOccurs=l maxOccurs=l) element defines the various schema's that define the data 
structures and shape of information managed by this service. Each schema is defined by its 
namespace URI, its location, and a preferred namespace alias. 

The /system/schemaMap/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /system/schemaMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /system/schemaMap/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformld of the node. The 
/system/schemaMap/schema (minOccurs=0 maxOccurs=unbounded) element defines a 
schema which defines data-structures and the shape of information managed by this service. 
Multiple schema elements exist for each service, once for each logical grouping of 
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information exposed by the service. The /system/schemaMap/schema/@namespace (anyURI 
minOccurs=0 maxOccurs=l) attribute specifies the namespace URI of this schema. The 
/system/schemaMap/schema/@schemaLocation (anyURI minOccurs=0 maxOccurs=l) 
attribute specifies the location (in the form of a URI) of the resource containing schema. 
When a schema is reachable through a variety of URIs, one schema element will exist for each 
location. 

The /system/schemaMap/schema/@alias (string minOccurs=0 maxOccurs=l) 
attribute specifies the preferred alias that should be used if possible when manipulating 
information covered by this schema in the context of this service. The 
/system/schemaMap/schema/{any} (minOccurs=0 maxOccurs=unbounded) provides for 
extensibility. The /system/wsdlMap (minOccurs=l maxOccurs=l) element defines the 
wsdlMap for this service. This map includes the location of WSDL documents, DISCO 
documents, and WSIL documents for this web service. These documents are used by 
applications to understand the format of messages that may be sent to the various services. 
The /system/wsdlMap/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
apphcations. Attempts to vmte this attribute are silently ignored. 

The /system/wsdlMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique 
ID assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute 
in the request message. Once an ID is assigned, the attribute is read-only and attempts to 
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write it are silently ignored. The /system/wsdlMap/@creator (string minOccurs=0 
maxOccurs=l) attribute identifies the creator in terms of userld, appid, and platfonnid of the 
node. 

The /system/wsdlMap/wsdl (minOccurs=0 maxOccuis=unbounded) element is used 
to specify the location of a WSDL file for this service. Multiple entries may exist pointing to 
the same file hosted in multiple locations, or to variations on the content within the WSDL 
files. 

The /system/wsdlMap/wsdl/@wsdlLocation (anyURI minOccurs=0 maxOccurs=l) 
attribute is a URI that specifies the location of the WSDL file. The 
/system/wsdlMap/wsdl/{any} (minOccurs=0 maxOccurs=unbounded) provides for 
extensibility. 

The /system/wsdlMap/disco (minOccurs=0 maxOccurs=unbounded) element is used 
to specify the location of a DISCO (web-services discovery) file for this service. Multiple 
entries may exist pointing to tiie same file hosted in multiple locations, or to variations on the 
content within the DISCO files. The /system/wsdlMap/disco/@discoLocation (anyURI 
minOccurs=0 maxOccurs=l) attiibute is a URI that specifies the location of the DISCO file. 
The /system/wsdlMap/disco/{any} (minOccurs=0 maxOccurs=unbounded) provides 
extensibility. 

The /system/wsdlMap/wsil (minOccurs=0 maxOccurs=ambounded) element is used to specify 
the location of a WSIL file for this service. Multiple entries may exist pointing to the same 
file hosted in multiple locations, or to variations on the content within the WSIL files. The 
/system/wsdlMap/wsil/@wsilLocation (anyURI minOccurs=0 maxOccurs=l) attiibute is a 
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URI that specifies the location of the WSIL file. The /system/wsdlMap/wsil/{any} 
(minOccurs=0 maxOccurs=unboundeci) provides extensibility. 

mvCalendar /Domain Specific Methods 

In addition to the standard methods, the myCalendar service supports the domain- 
specific methods, getCalendarDays, getFreeBusyDays, getQuickView, sendMeeting, respond 
and updateReminder. 

The myCalendar/getCalendarDaysRequest is a calendar date range event generator. 

This method is accessed using a request message, and in response may generate a response 

message or a SOAP Fault message. The following sample document fi-agments illustrate the 

structiu-e and meaning of the elements and attributes in the request and response messages. 

The following is a request message XML fi-agment for getCalendarDays; it takes a startDate 

and an endDate to define the duration over which calendar events are returned: 

<m:getCalendarDaysRequest 
xmlns:m="http://schemas.microsoft.coni/hs/2001/lO/myCalendar" 
xmlns:hs="http://schemas.rnicrosoft.com/hs/2001/10/core''>i..i 
<m:calendarType>o.. i </m: calendarType> 
<m: startTime>i i </m: startTimO 
<m:endTime>i ..i</m:endTime> 
<m:removeRecurrence>o..i</m:removeRecurrence> 
</m:getCalendarDaysRequest> 

The /getCalendarDaysRequest (minOccurs=l maxOccurs=l) fimction returns an XML 
stream of calendar appointments / events between two dates. Recurrence rules are expanded 
to create individual calendar items. Holidays are represented as all-day events, and these are 
retumed as well. The getCalendarDays method is a query-retrieval of data, but the behavior 
expands recurrence rules into individual (aliased) events, adds in holidays, and adds regular 
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events and sorts the entire list based on start time. No merging of event blocks occurs. Any 
object which overlaps the method parameters {startTime, endTime} will be returned. For 
example, if an event crosses midnight and the startTime is 12am, that event will be returned. 
In case the startDate, endDate is one day, the events are sorted in the following order: 
holidays, all-day events, and regular events (based on startTime). The {startTime, endTime] 
time window can define any interval: 24hr period, week, month, or any other user-defined 
period. 

The getCalendarDays method retums the calendaring info of any puid that is specified 
for which the caller has sufficient privileges. The user's own puid must be specified to retrieve 
their own information. The getCalendarDays method may be used to retrieve multiple 
calendar data fi-om other users using <h:key instance="0" clustei="0" puid="xyz'V> in the 
SOAP headers provided that puid "xyz" is provisioned on the .NET Calendar server, and 
provided that the user has been granted access in puid '*xyz"*s rolelist. 

The ZgetCalendarDaysRequest/calendarType (string minOccurs=0 maxOccurs=l) 
optionally specifies the calendar type to retum, as set forth in the calendar-types table above. 
The system defaults to Gregorian if not specified. 

The ZgetCalendarDaysRequest/startTime (dateTime minOccurs=l maxOccurs^l) 
specifies the starting time window of calendar objects to retrieve. This dateTime also contains 
the timeZone to retrieve the calendar information in. 

The ZgetCalendarDaysRequest/endTime (dateTime minOccurs=l maxOccurs=l) field 
contains the ending time window to retrieve calendar objects. This dateTime also contains the 
timeZone to retrieve the calendar information in, and needs to be the same timeZone as 
StartTime. 
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Normally, the recurrence sub-schema, (minus modifiedException and minus 
deletedExceptionDate components) is returned with each instance of a recurring event, like 
"recurring-instance" and "recurring-exception". This allows clients to properly render the 
recurrence pattem without having to expHcitly query the recurring-master. However, because 
5 it is heavy on bandwidth, .NET Calendar includes the option to not return this data, via 
/getCalendarDaysRequest/removeRecurrence (boolean minOccurs=0 maxOccurs=l). 

Upon successful completion of the above method, a response message, 
myCalendar/getCalendarDaysResponse, is generated. In the response, calendar events are 
returned with their recurrence rules expanded into first-class events. These events have aliased 

O 10 PUIDs, logically as part of the same event. Recurrence information is stripped fi-om the 

□ 

fU original event. The following is a response schema outline: 

ry 

<m:getCalendarDaysResponse selectedNodeCount="..." status^"..." 
xmlns:m="http://schemas.microsoft.com/hs/200 1/1 0/myCalendar" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 

<m:event instanceType="..." calendarType="..." advanceHijriValue="..." changeNumber="..." 
id="..." creator="...">o..unboui,ded 

<m:body changeNumber="...">i , 
<m:cat ref=",..">o..unbounded</m:cat> 
<m:title xml:lang="..." dir="...">,..,</m:title> 
<m:fullDescription xml:lang="..." dir="...">o.,,</m:fullDescription> 
<m:location xml:lang="..." dir="...">o..i</m:location> 
<m:meetingStatus>o..i</m:meetingStatus> 
<m:recurrenceId>o.i</m:recurrenceId> 
<m:lastUpdateTime>o..i</m:lastUpdateTime> 
<m:startTime>, ,</m: startTime> 
<m:endTime>,..,</m:endTime> 
<m:allDay>o..i</m:allDay> 
<m:floating>o..i </m: floating> 
<m:travelTimeTo>o..i</m:travelTimeTo> 
<m:travelTimeFrom>o..i</m:travelTimeFrom> 
<m: freeBusyStatus>o.. i</m:freeBusyStatus> 
<m:cuid>o.. i </m:cuid> 
<m:organizer>o..i 

<hs:namc xml:lang="..." dir="...''>o„i</hs:name> 
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<hs:puid>o..i</hs:puid> 

<hs:email>o..,</hs:eniail> 
</m:organi2er> 
{any} 
</m:body> 

<ni:attachment>o..unbomKkd 
<m:name xml:lang="..." dir="...">, .,</in:name> 
<m: contentType> i i </m: contentType> 

<m:contentTransferEncodmg>,..|</m:contentTransferEncoding> 
<m: size>i i </m: size> 

<m:attachmentBody>,..,</m:attachinentBody> 
</m:attachment> 
<m:reminder>o..i 

<m:set>i.j<;/m:set> 

<m:to xml:lang="..." dir="...">,..,</m:to> 
<m:offset>,..i</m:offset> 
<in:interruptability>o..i</m:interruptability> 
<m:lastSentTime>i..i</m:lastSentTime> 
<m:nextTriggerTime>,..,</m:nextTriggerTime> 



<hs:name xml:lang="..." dir="...">o.i</hs:name> 

<hs:puid>o..i</hs:puid> 

<hs:email>o.. i </hs :email> 

<m: inviteType> , i </m: inviteType> 

<m:responseTime>o..i</m:responseTime> 

<in:responseType>o..i</m:responseType> 

<m:counterProposeStartTime>o.. i </m:counterProposeStartTime> 

<m:counterProposeEndTime>o.j</m:counterProposeEndTime> 

<m:counterProposeLocation>o..i</m:counterProposeLocation> 

<m:responseBody xml:lang="..." dir="...">o,.i</m:responseBody> 

{any} 
</ni:attendee> 
<m:recurrence>a.i 

<m:rule>i.,i 

<m:creationDate>i„,</m:creationDate> 

<m:firstDayOfWeek>,..i</m:firstDayOfWeek> 

<m:tzid>o..i</m:tzid> 

<m: isLeap Year>o.. i </ni: isLeap Year> 

<m:leapMonthValue>o..i<;/m:leapMonthValue> 
<m:repeat>i..i 

<m:daily dayFrequency="...">o..,</m:daily> 

<m:weekly su="..." mo="..." tu="..." we="..." th="..." fr="..." sa="..." 
weekFrequency="...">o. ,</m:weekly> 



<m:monthlyByDay su="..." mo="..." tu="..." we="..." th="..." fr="..." sa="..." 



monthF^equency='^./'weekdayOfMonth=*^./%..l</m:monthlyBy 

<m:monthly monthFrequency="../' day="..." forceExact="...">o i</m:monthly> 
<m:yearlyByDay su="..." mo="..." tu="..." we="..." th="..." fr="..." sa=". " 

yearFrequcncy="..." weekdayQfMonth=".,." month="..;'>o i</m:yearlvByDay> 



</m:reminder> 
<m:attendee>o 



0.. unbounded 
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<m:yearly yearFrequency="..." month="..." day="..." forceExact="...">o i</m:yearly> 
{any} 
</m:rqjeat> 

<m: windowEnd>o., i </m: windowEnd> 
<m:rq)eatForever>o.. i </m:repeatForever> 
<m:repeatInstances>o.. i </m:repeatInstances> 
</m:rule> 
</m:recuiTence> 
</m:event> 

</m:getCalendarDaysResponse> 

The /getCalendarDaysResponse (minOccurs=l maxOccurs=l) response XML blob 
format, comprises the base event type minus recurrence. The 

/getCalendarDaysResponse/@selectedNodeCount (int minOccurs=0 maxOccurs=l) This 
attribute is used to return the number of selected nodes, selected by the corresponding data 
language operation. The /getCalendarDaysResponse/@status (string minOccurs=l 
maxOccurs^l) attribute indicates the status of the method. 

If the status is success, the corresponding method was completed successfully. If the 
status is failure, the corresponding method was not completed successfully. If the status is 
rollback, the method failed, but was rolled back to its pre-updateBlock status. If the status is 
notAttempted, the corresponding method was not attempted. This occurs when a previous 
operation failed. 

The /getCalendarDaj^Response/event (minOccurs=0 maxOccurs=unbounded) , if 
present, may have a /getCalendarDaysResponse/event/@instanceType (string minOccuis=0 
maxOccurs=l) field which distinguishes between a single instance of an event or an instance 
of a recurring event. The recuiring instance is a modified exception if eventBody/recurrenceld 
is present: single, recurring-master, recurring-instance, recurring-exception. The 
/getCalendarDaysResponse/event/@calendarType (string minOccurs=0 maxOccurs=l) field 
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identifies an enumeration which determines the kind of calendar event this is, as set forth in 
the above calendar type table. 

The/getCalendarDaysResponse/event/@advanceHijriValue (int minOccurs=0 
maxOccurs=l) field is required for Hijri calendar support. @advanceHijriValue ranges from 
5 {-3,-2,-1,1,2,3} and is added to the current date, but the day of the week stays the same. For 
example, if today is the 24th and @advanceHijriValue is set to be +2, then the user sees the 
date as being the 26th. Typically @advanceHijri Value is +/-1, and this suffices in most cases. 
Theoretically it can be any number, but the worst case scenario is +/-3. 

The/getCalendarDaysResponse/event/@changeNumber (minOccurs=l maxOccurs=l) 
O 1 0 changeNumber attribute is designed to facilitate caching of the element and its descendants. 

ru 

ru 
m 



1^ 



This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this atttibute are silently ignored. 
„ The /getCalendarDaysResponse/event/@id (minOccurs=l maxOccurs=l) attribute is a 

□ globally unique ID assigned to this element by .NET My Services. Normally, .NET My 

ru 

ru 1 5 Services generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The /getCalendarDaysResponse/event/@creator (minOccurs=l maxOccurs=l) 
20 attribute identifies the creator in terms of userld, appid, and platformid of the node. 

The /getCalendarDaysResponse/event/body (minOccurs=l maxOccurs=l) includes the 
/getCalendarDaysResponse/event/body/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute, which is designed to facilitate caching of the element and its 
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descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /getCalendarDaysResponse/event/body/cat (minOccurs=0 
maxOccurs=unbounded) element is used to categorize the element that contains it by 
referencing either a global category definition (in either the .NET Categories service system 
document or an external resource containing category definitions), or by referencing an 
identity-centered category definition in the content document of the .NET Categories service 
for a particular PUID. 

The /getCalendarDaysResponse/event/body/cat/@ref (anyURI minOccurs=l 
maxOccurs=l) attribute references a category definition (catDef) element using the rules 
outlined in the .NET Categories section, described above. 

The /getCalendarDaysResponse/event/body/title (string minOccurs=l maxOccurs=l) 
includes the /getCalendarDaysResponse/event/body/title/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The /getCalendarDaysResponse/event^ody/title/@dir 
(string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
the localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/body/fiillDescription (string minOccm-s=0 
maxOccurs=l) element contains a fi-ee form, fiiU description of the event. The 
/getCalendarDaysResponse/event/body/fullDescription/@xml:lang(minOccurs=l 
maxOccm^=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
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type of the content within this element. The 

/getCalendarDaysResponse/event/body/fullDescription/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The/getCalendarDaysResponse/event/body/location (string minOccurs=0 
maxOccurs=l) optional element contains the event's location. The 
/getCalendarDaysResponse/event/body/Iocation/@xml:lang (minOccurs^l maxOccurs=l ) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /getCalendarDaysResponse/event/body/location/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/body/meetingStatus (string minOccurs=0 
maxOccurs=l) tracks the status of this meeting {not-sent, sent, cancelled}. A regular 
^pointment will not have this element. If <meetingStatus> exists, this event should be 
rendered as a meeting, not as an appointment. 

The /getCalendarDaysResponse/event/body/recurrenceld (dateTime minOccurs=0 
maxOccurs=l) recurrence id indicates the original start time of an occurrence of a recurring 
master appointment. It is required to identify what instance an exception is modifying, since 
users are allowed to change the start time on the orphan. The recurrenceld method is stored in 
UTC. It does not appear in the master schema, except in the specific case that an attendee is 
invited to an instance of a recurring event. Otherwise, <recurrenceld> is usually only a part of 
getCalendarDays. 

-87- 



The /getCalendarDaysResponse/event/body/lastUpdateTime (dateTime minOccurs=0 
maxOccurs=l) field is updated by the organizer whenever s/he creates and sends a new 
meeting request. This helps the attendee to identify which meeting request is the most recent 
one. It is stored in coordinated universal time (UTC). This property is not modifiable by 
5 clients and is assigned by the server on modification and by the sendMeetingRequest. 

The ZgetCalendarDaysResponse/event/body/startTime (dateTime minOccurs=l 
maxOccurs=l) startTime method defines the start time of the event. An all-day event by 
convention starts at 12:00:00 AM of the day of the event. This is stored in UTC. Maximum 
range is January 1, 1753 to December 31, 9999 to an accuracy of 3.33 miUiseconds. If this 
10 event is a recurring event, <startTime> defines the dateTime when the recurrence window 

Ij 
fU 

12 starts. The recurring master does not have to be an instance of the recurring event itself. An 

fit 

[fl event in March set to recur every April will only appear in April. 



S 



The /getCalen(ia^DaysResponse/event^ody/endTime (dateTime minOccurs=l 
maxOccurs=l) endTime method defines the end time of the event. An all-day event by 
p 1 5 convention ends at 1 1 :59:59 PM of the ending day. This is stored in UTC. Maximum range 
IS January 1, 1753 to December 31, 9999 to an accuracy of 3.33 milliseconds. The duration of 
the event is inferred fi-om endTime - startTime. 

The /getCalendarDaysResponse/event/body/allDay (boolean minOccurs=0 
maxOccurs=l) element indicates a regular event by being false or being absent. Otherwise, 
20 this attribute indicates that the event is an all-day event. All day events may span multiple 
days. By convention, all day events start at 12:00:00 am of the day of startTime, regardless of 
what time it actually is, and it will end at 1 1 :59:59 pm of the endTime date. In other words, if 
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the allDay element is present and has value=true, .NET Calendar will ignore the actual times 
of the events and consider only the date part of the field. 

The allDay tag is meant to operate as a hint to UI renders to display specialized icons 
indicating an all-day event. allDay events are distinguishable between 24-hr events starting at 
12am. hi the case of a meeting request, an allDay event will not appear in the local user's 
time zone, but rather in the organizer's time zone. 

The /getCalendarDaysResponse/event/body/floating (boolean minOccurs=0 
maxOccurs=l) floating attribute indicates that this event is to occur in the current local time 
zone no matter what time zone the system is cunently in (that is, it floats). For example, 
holidays are floating events. As another example, it may be useful to schedule medication 
regardless of an actual time zone, whereby a floating attribute is used with such an event. 
Floating values are stored as-is: no time-zone translations are needed to convert them to UTC 
or any local time zone. % 

The ZgetCalendarDaysResponse/event/body/travelTimeTo (int minOccurs=0 
maxOccurs=l) field contains the amount of time (in minutes) that it takes to travel to the 
meeting location. The ZgetCalendarDaysResponse/event/body/travelTimeFrom (int 
minOccurs=0 maxOccurs=l) field contains the amount of time (in minutes) that it takes to 
return fi-om the meeting location. These optional elements show in firee/busy calculations. 

The ZgetCalendarDaysResponse/event/body/freeBusyStatus (string minOccurs=0 
maxOccurs=l) optional element annotates the freeBusy behavior of this event. Events by 
default appear as "busy". The user may explicitly define this event to be annotated by setting 
.NET Calendar values to fi-ee, tentative, busy or away. 

The /getCalendarDaysResponse/event/body/cuid (string minOccurs=0 maxOccurs=l) 
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cuid (CorrelationUID) links an organizer's event to an attendee's event. It identifies which 
response from an attendee is for which request from an organizer, and which meeting request 
update from the organizer is for which previously accepted meeting by the attendee. The 
"cuid" is the same on both the attendee's and the organizer's copy of the appointment. It is 
5 also identical on the exception and the recurring master. This value is assigned by the .NET 
Calendar server and is non-modifiable. 

The /getCalendarDaysResponse/event/body/organizer (minOccurs=0 maxOccurs^l) 
field contains the email address of the event organizer. The 

/getCalendarDaysResponse/event/body/organizer/name (string minOccurs=0 maxOccurs=l) 
Q 10 optional element specifies the name for the enclosing element. The 

a 

fU /getCalendarDaysResponse/event^ody/organizer/name/@xml:lang(minOccurs=l 
f y maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3 166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

ry 

fU 15 /getCalendarDaysResponse/event/body/organizer/name/@dir (string minOccurs=0 

p 

'f* maxOccurs=l ) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/body/organizer/puid (string minOccurs=0 
maxOccurs=l) optional element specifies the PUID for the enclosing element. The 
20 /getCalendarDaysResponse/event/body/organizer/email (string minOccurs=0 maxOccurs=l) 
optional name specifies an e-mail address for the enclosing element. 

The /getCalendarDaysResponse/event/body/{any} (minOccurs=0 
maxOccurs=unbounded) provides for additional body elements. 
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The /getCalendarDaysResponse/event/attendeeEventExtra (minOccurs=0 
inaxOccurs=l) field contains additional information about an event, found only in an event 
invitee's schema. The 

/getCalendarDaysResponse/event/attendeeEventExtra/@changeNumber(minOccurs=l 
5 maxOccurs=l) changeNimiber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The ZgetCalendarDaysResponse/event/attendeeEventExtra/intendedFreeBusy (string 
minOccurs=0 maxOccurs=l) element is the event organizer's fi-eeBusy information and is 
p 10 thus equal to event/freeBusyStatus. Invitees may overwrite event/freeBusyStatus with a new 

H 

fU value, and intendedFreeBusy is intended to store the organizer's original fi-eeBusyStatus. 

|:s»t 

ry 
m 

«£ 

s 

Q time (Now) when the organizer sends a meeting invitation. When the attendee responds, they 

ru 

fU 15 update their responseTime. When the organizer receives responses, they will honor only those 

Q 

that have a higher responseTime than what is maintained in his/her own copy of the event for 
each attendee. While processing the response, the organizer will update their responseTime. 
This guarantees that the organizer honors only the most recent response fi-om the attendee. 
This is stored in UTC. 

20 The /getCalendarDaysResponse/event/attendeeEventExtra/responseType (string 

minOccurs=0 maxOccurs=l) accept status indicates the valid types of responses that an 
attendee can reply with {accept, declme, tentative, counterpropose} . The absence of this field 



The ZgetCalendarDaysResponse/evenl/attendeeEventExtra/responseTime (dateTime 
minOccurs=0 maxOccurs=l) field contains the reply time on each attendee is set to the current 
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indicates that no response has been recorded (either the invitation has not been sent, or that a 
reply has not been received). 

The/getCalendarDaysResponse/event/attendeeEventExtra/counterProposeStartTime 
(dateTime niinOccurs=0 maxOccurs=l) field contains the counter proposal start time 
information. If responseType=[counterPropose], then either the {startTime, endTime}, or 
location, or both can be present. This is the invitee's counterproposal for a new start time for 
the meeting. This is stored in UTC. 

The/getCalendarDaysResponse/event/attendeeEventExtra/counterProposeEndTime 
(dateTime minOccurs=0 maxOccurs=l) field contains the counter proposal end time 
information. If responseType=[counterPropose], then either the {startTime, endTime}, or 
location, or both can be present. This is the invitee's counterproposal for a new end time for 
the meeting. This is stored in UTC. 

The/getCalendarDaysResponse/event/attendeeEventExtra/counterProposeLocation 
(string minOccurs=0 maxOccurs=l) field contains the counterproposal location information, 
field contains the counter proposal start time information. If responseType=[counterPropose], 
then either the {startTime, endTime}, or location, or both can be present. This is the invitee's 
counterproposal for a location for the meeting. 

The ZgetCalendarDaysResponse/event/attendeeEventExtra/responseBody (string 
minOccurs=0 maxOccurs=l) field contains an optional message for invitees to include along 
with the response. The 

/getCalendarDaysResponse/event/attendeeEventExtra/responseBody/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3 166 country code as described in RFC 1766. The value of this attribute indicates 
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the language type of the content within this element. The 
/getCalendarDaysResponse/event/attendeeEventExtra/responseBody/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the base direction of directionally 
neutral text. Possible values include rtl (right to left) and Itr (left to right). 

The/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder 
(minOccurs=0 maxOccurs=l) field stores information of a delegate who responds on behalf of 
an invitee. The 

ZgetCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/name (string 
minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing element. 
The 

/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/name/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3 166 coimtry code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/puid 
(string minOccurs=0 maxOccurs=l) optional element specifies the PUID for the enclosing 
element. The/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/email 
(string minOccurs=0 maxOccurs=l) optional name specifies an e-mail address for the 
enclosing element. The /getCalendarDaysResponse/event/attendeeEventExtra/{any} 
(minOccurs=0 maxOccurs=unbounded) provides for additional attendee extra properties. 
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The /getCalendarDaysResponse/event/attachment (minOccurs=0 
maxOccurs=unbounded) element contains attachment metadata, name, content-type and id's, 
and may also contain the attachmentBody. The 

/getCalendarDaysResponse/event/attachment/@changeNumber(minOccurs=l maxOccurs=l) 
5 changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to ^plications. Attempts to write this attribute are silently ignored. 

The /getCalendarDaysResponse/event/attachment/@id (minOccurs=l maxOccurs=l) 
attribute is a globally unique ID assigned to this element by .NET My Services. Normally, 
53 1 0 .NET My Services generates and assigns this ID during an insertRequest operation, or 
^ possibly during a replaceRequest. Application software can override this ID generation by 
f fi specifying the useClientlds attribute in the request message. After an ID has been assigned, 

.£ 

s the attribute is read only and attempts to write it are silently ignored. 

fa 

The /getCalendarDaysResponse/event/attachment/@creator (minOccurs=l 

fU 

p 15 maxC)ccurs=l) attribute identifies the creator in terms of userld, appid, and platformid of the 

il 

node. The /getCalendarDaysResponse/event/attachment/name (string niinOccurs=l 
maxOccurs=l) element contains information about an individual attachment in a mail 
message. The /getCalendarDaysResponse/event/attachment/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
20 country code as described in RFC 1 766. The value of this attribute indicates the language 
type of the content within this element. The 

/getCalendarDaysResponse/event/attachment/name/@dir (string minOccurs=0 maxOccurs=l) 
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optional attribute specifies the default layout direction for the localized string. Valid values 
are rtl (right to left) and Itr (left to right). 

The ZgetCalendarDaysResponse/event/attachment/contentType (string minOccurs=l 
maxOccurs=l) element contains the content type of the attachment. The 

ZgetCalendarDaysResponse/event/attachment/contentTransferEncoding (string minOccurs=l 
maxOccurs=l) element contains the encoding of the attachment. This information is 
necessary for decoding the attachment. The /getCalendarDaysResponse/event/attachment/size 
(unsignedLong minOccurs=l maxOccurs=l) element contains the size of the attachment in 
bytes. The ZgetCalendarDaysResponse/event/attachment/attachmentBody (base64Binary 
minOccurs=l maxOccurs=l) element contains the contents of the attachment. 

The /getCalendarDaysResponse/event/reminder (minC)ccurs=0 maxOccurs=l) is 
directed to reminders. A user may optionally define a reminder for this appointment. 
Reminders for recurring appointments will be sent periodically before the appointment, as per 
the rules defined in the reminder subschema below. A non-recurring event may define no 
reminders, define a reminder with <set> = "true" or define a reminder with <set> = "false". 

A recurring meeting may have no reminders defined, or a recurring reminder defined 
with all instances receiving reminders. To define no reminders by default, but to define 
reminders for particular meeting instances in the exception body, a reminder <set> = "false" is 
created, and turned on and/or modified for particular instances. To define a recurring 
reminder, but turn it off for particular meeting instances, a reminder <set> = "true" is created, 
and tumed off for particular instances. 

If the event's reminder subschema is non-existent, yet the exception body has a 
reminder blob, then the exception reminder is ignored. An alternative is to require this. 
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The /getCalendarDaysResponse/event/reminder/@changeNumber (minOcciirs=l 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /getCalendarDa)^Response/event/reminder/@id (minOccurs=l maxOccurs=l) 
attribute is a globally unique ID assigned to this element by .NET My Services. Normally, 
.NET My Services generates and assigns this ID during an insertRequest operation or possibly 
during a replaceRequest. Application software can override this ID generation by specifying 
the useClientlds attribute in the request message. After an ID has been assigned, the attribute 
is read only and attempts to write it are silently ignored. 

The /getCalendarDaysResponse/event/reminder/@creator (minOccurs=l 
maxOccurs=l) attribute identifies the creator in terms of userld, appid, and platformld of the 
node. The /getCalendarDaysResponse/event/reminder/set (boolean minOccurs=l 
maxOccurs=l) field maintains a Boolean flag that indicates whether the reminder is active for 
this event. In most cases, this will be true, but in the case of a recurring appointment, this flag 
may default to true with specific instances not to be remmded, or default to false, with specific 
instances to be reminded. 

The /getCalendarDaysResponse/event/reminder/to (string minOccvu^=l 
maxOccurs=l) stores a fiiendly name that this reminder is being sent to. The 
/getCalendarDaysResponse/event/reminder/to/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /getCalendarDaysResponse/event/reminder/to/@dir (string 
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minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string, VaUd values are rtl (right to left) and Itr (left to right). 



The /getCalendarDaysResponse/event/reminder/offset (int minOccurs=l 
maxOccurs=l) field specifies the offset, in minutes, of how long before the event the user 
should be reminded. Recommended values are set forth in the following table: 



Value 


Description 


5, 10, 20, 30, 45 


5, 10, 20, 30, 45 minutes before the event 


60, 120, 180, 


1, 2, 3 hours before the event 


startTime - startDay 


The day of the event (reminder sent at 12:00am) 


startTime - (startDay - (1440 * x)) 


"x" days before the event (reminder sent at 12:00am 
"x" days before) 



The /getCalendarDaysResponse/event/reminder/interruptability (int minOccurs=0 
maxOccurs=l) optional element defines how interruptible this event is and it is used by 
notification routing software to make decisions about the relay and deferral of notifications 
that might occur while this meeting is active. The value contained in this element is a 
numeric value between one and ten. Low values represent a high cost of disruption, high 
values represent a low cost of disruption. 

The ZgetCalendarDaysResponse/event/reminder/lastSentTime (dateTime minOccurs=l 
maxOccurs=l) field is required by the reminder engine. The 

ZgetCalendarDaysResponse/event/reminder/nextTriggerTime (dateTime minOccurs= 1 
maxOccurs=l) determines the next time to trigger reminder. 

The /getCalendarDaysResponse/event/attendee (minOccurs=0 
maxOccurs=unboxmded) includes the attendeeType, which contains the information about an 
attendee, including the display, email, puid, and the attendee's response. 
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The /getCalendarDaysResponse/event/attendee/name (string minOcciirs=0 
maxOccurs=l) optional element specifies the name for the enclosing element. The 
/getCalendarDaysResponse/event/attendee/name/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
5 described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /getCalendarDaysResponse/event/attendee/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/attendee/puid (string minOccurs=0 

□ 10 maxOccurs=l) optional element specifies the PUID for the enclosing element. The 

Q 

fU /getCalendarDaysResponse/event/attendee/email (string minOccurs=0 maxOccurs=l) optional 
name specifies an e-mail address for the enclosing element. The 

/getCalendarDaysResponse/event/attendee/inviteType (string minOccurs=l maxOccurs=l) is 

□ used by a meeting organizer to define the kind of invitee, e.g., as required, optional, or a 

ru 

fU 1 5 resource (e.g., meeting room). 

C3 

^" The ZgetCalendarDaysResponse/event/attendee/responseTime (dateTime minOccurs=0 

maxOccurs=l) reply time on each attendee is set to the current time (Now) when the organizer 
sends a meeting invitation. When the attendee responds, they update their responseTime. 
When the organizer receives responses, they will honor only those that have a higher 
20 responseTime than what s/he maintains in his/her own copy of the event for each attendee. 
While processing the response, the organizer will update their responseTime. This guarantees 
that the organizer honors only the most recent response firom the attendee. This is stored in 
UTC. 
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The /getCalendarDaysResponse/event/attendee/counterProposeStartTime (dateTime 
minOccurs=0 maxOccurs=l) field contains the counter proposal start time information. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new start time for the meeting. 
5 This is stored in UTC. 

The ZgetCalendarDaysResponse/event/attendee/counterProposeEndTime (dateTime 
minOccurs=0 maxOccurs=l) field contains the counter proposal end time information. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new end time for the meeting. This 

□ 10 is stored in UTC. 

O 

i'U The ZgetCalendarDaysResponse/event/attendee/counterProposeLocation (string 

J^" minOccurs=0 maxOccurs=l) field contains the counter proposal location information, field 

contains the counter proposal start time information. If responseType=[counterPropose], then 
Q either the {startTime, endTime} , or location, or both can be present. This is the invitee's 

ru 

fU 1 5 counterproposal for a location for the meeting. 

C3 

' The ZgetCalendarDaysResponse/event/attendee/responseBody (string minOccurs=0 

maxOccurs=l) field contains an optional message for invitees to include along with the 
response. The /getCalendarDaysResponse/event/attendee/responseBody/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
20 or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/getCalendarDaysResponse/event/attendee/responseBody/@dir (string minOccurs=0 
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maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/attendee/{any} (minOccurs=0 
maxOccurs=unbounded) allows for extensibility. 
5 The /getCalendarDaysResponse/event/recurrence/rule (minOccurs=l maxOccurs=l) 

includes /getCalendarDaysResponse/event/recurrence/rule/creationDate (dateTime 
minOccurs=l maxOccurs=l), which is required to determine which timezone recurrence rule 
to use. The startTime of the event is not used because of the abiUty to create events in the past 
and in the fixture--^ 

Q 10 The /getCalendarDaysResponse/event/recurrence/rule/firstDayOfWeek (string 

□ 

minOccurs=l maxOccurs=l) stores what the first day of the week is for this user. Typical 



ru 
m 



values are (su) Sunday or (mo) Monday. This is used for calculating the recurrence 
~f expansion, and allows recurring meetings to be expanded in the organizer's FirstDOW instead 
C3 of the invitee's FirstDOW. 

ru 

15 The /getCalendarDaysResponse/event/recurrence/rule/tzid (int minOccurs=0 

C3 

' maxOccurs=l) field identifies the time zone for this recurring event. All dateTime 

information in this event is stored in UTC (converted fi-om the local time zone defined by the 
time zone sub-schema). If this field is absent, the recxuring event is assumed to be recurring in 
UTC time. However, it is only a floating recurring event if the <floating> attribute is set: 



<timeZone floating=** 

id 
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<standardBias> 

</standardBias> 

<additionalDaylightBias> 

0..1 

</additionalDaylightBias> 
<standardDate> 

0..1 

<transitionRule weekdayOfMonth="..." day="..." dayOfMonth="..." month="... 
afterDay="..."> 

<VtransitionRule> 

<transitionTime> 

</transitionTime> 

</standardDate> 
<daylightDate> 

0..1 

<transitionRule weekdayOfMonth="..." day="..." dayOfMonth="..." month="...' 
afterDay="..."> 

</transitionRule> 

<transitionTime> 

1..! 

</transitionTime> 

</daylightDate> 
<;/timeZone> 



The /getCalendarDaysResponse/event/recurrence/rule/isLeapYear (boolean 
minOccurs=0 maxOccurs=l) provides International calendar support. It is possible to derive 
isLeapYear from leapMonthValue, but .NET Calendar stores both separately. The 
/getCalendarDaysResponse/event/recurrence/rule/leapMonthValue (int minOccurs=0 
maxOccurs=l) <leapMonthValue> cannot be derived from a particular year and thus must be 
stored. For example, a user creates a recurrence on a Hebrew Lunar calendar. The year is a 
leap year and it has 13 months. In that year, the leapMonthValue is 7. 
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The /getCalendarDaysResponse/event/recurrence/rule/repeat (minOccurs=l 
maxOccxirs=l) may includes the 

/getCalendarDaysResponse/event/recurrence/rule/repeat/daily (minOccurs=0 maxOccurs=l), 
field, which specifies the number of days to repeat, e.g., repeat every [...] days. The 
5 /getCalendarDaysResponse/event/recurrence/rule/repeat/daily/@dayFrequency (int 

minOccurs=l maxOccurs=l) specifies the periodicity of days over which repetition occurs, 
for example, repeat every 3 days. 

The /getCalendarDaysResponse/event/recurrence/rule/repeat/weekly (minOccurs=0 
maxOccurs=l) field, if present, is directed to repeating weekly, e.g., repeat every [...] week(s) 

£3 

Q 10 on {su,mo,tu,we,th,fi',sa} . The presence of a weekday attribute means to repeat on this 
^ particular day. Any combination of the seven days is valid. 

m 

Cn The/getCalendarDaysResponse/event/recurrence/rule/repeat/weekly/@weekFrequency 
(int minOccurs=0 maxOccurs=l) repeatWeekly recurrence occurs every period of weeks. If 

ca 

f|j the attnbute is not present, it defaults to 1 (every week). 

rO 

C3 15 The /getCalendarDaysResponse/event/recurrence/rule/repeat/monthlyByDay 

(minOccurs=0 maxOccurs=l) specifies to repeat on the [First, Second, Third, Fourth, Last] 
{su, mo, tu, we, th, fi-, sa} of every [...] month(s). Any combination of the {weekday} 
attributes are valid, including user-defined combinations for weekdays and weekend days. 
The 

20 /getCalendarDaysResponse/event/recurrence/rule/repeat/monthlyByDay/@monthFrequency 
(int minOccurs=0 maxOccurs=l) specifies the month periodicity to recur on. If this attribute 
is not present, it defaults to 1 (every month). 
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# 



The 

/getCalendarDaysResponse/event/recurrence/mle/repeat/monthlyByDay/@weekd 
(string minOccurs=l maxOccurs=l) specifies which week m a month [first, second, third, 
fourth, last]. 

5 The /getCalendarDaysResponse/event/recurrence/rule/repeaiymonthly (minOccurs=0 

maxOccurs=l) repeats the occurrence every month on a particular day. The very first 
occurrence is created fi-om the parent event's startTime and endTime, but the recurrence 
occurs as follows: Repeat every month on [day] of [month]. Repeat every [monthFrequency] 
month(s) on [day] of [month]. Typically, the first occurrence is also an instance of the 

C3 10 recurrence, but this need not be the case. 

C3 

ru 
ru 



ru 



The 

/getCalendarDaysResponse/event/recurrence/rule/repeat/monthly/@monthFrequency (int 
minOccurs=0 maxOccurs=l) optional attribute indicates the month periodicity. By defauh, it 
is 1, periodic every month. The start of the periodicity is determined fi-om event startTime. 
1 5 The /getCalendarDaysResponse/event/recurrence/rule/repeat/monthly/@day (int minOccurs=l 
maxOccurs=l) specifies the day of the month to recur on. Value is between one and 3 1 . 

A forceExact rule handles invalid day-month combinations. The proper recurrence 
pattern for repeating on the last day of the month is to use repeatMonthlyByDay. "Repeat on 
the [last] [day, weekday, weekend day] of...". By default, an invalid day-month combination 
20 will cause .NET Calendar to search backwards to find a valid day-month combination. If 
/getCalendarDaysResponse/event/recurrence/rule/repeat/monthly/@forceExact (boolean 
minOccurs=0 maxOccurs=l) is true, an invalid starting [month ,day] combination such as [6, 
31] is ignored and will not be included as an instance of the recurrence. With forceExact, 
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day=31 will only pick up months that have 31 days, day=30 will pick up all months except 
February, day=29 will pick up all months except February, except on leap years. February 29 
is included on leap years. 

The/getCalendarDaysResponse/event/recurrence/rule/repeat/yearlyByDay 
5 (minOccurs=0 maxOccurs=l) specifies how to repeat on the [First, Second, Third, Fourth, 
Last] {su, mo, tu, we, th, fr, sa} of [Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, 
Dec] every [yearFrequency] years. 

Any combination of the {weekday} attributes are valid, including user-defined 
combinations denoting weekdays and weekend days. This element's attributes contain 

C3 10 whether a given day is or is not considered by the user as part of the work week. If this 

□ 

element has no attributes, it is assumed that the user has a Monday to Friday work week. 

fU 

The 

g /getCalendarDaysResponse/event/recurrence/rule/repeat/yearlyByDay/@yearFrequency (int 

U 

C3 minOccurs=0 maxOccurs=l) optional attribute indicates the year periodicity. By default, it is 

ru 

15 1 (repeat every year). 

O 

^ The 

/getCalendarDaysResponse/event/recurrence/rule/repeat/yearlyByDay/@weekdayOfMonth 
(string minOccurs=l maxOccurs=l) Specifies which week in a month [first, second, third, 
fourth, last] to repeat. 

20 The/getCalendarDaysResponse/event/recurrence/rule/repeat/yearlyByDay/@month 
(int minOccurs=l maxOccurs=l) contains a value between one and thirteen (some calendars 
have thirteen months). 
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The /getCalendarDaysResponse/event/recurrence/rule/rq)eat/yearly (minOccurs=0 
maxOccurs=l) specifies to repeat every year on a particular date. The very first occurrence is 
created fi-om the parent event's startTime and endTime, but the recurrence occurs as follows: 
Repeat yearly on [day] of [month]. Repeat every [yearFrequency] years on [day] of [month]. 
5 Typically, the first occurrence is also an instance of the recurrence, but this need not be the 
case. 

The /getCalendarDaysResponse/event/recurrence/rule/repeat/yearly/@yearFrequency 
(int minOccurs=0 maxOccurs=l) optional attribute indicates the year periodicity. By default, 
it is 1 (repeat every year). The 

C3 10 /getCalendarDaysResponse/event/recurrence/rule/repeat/yearly/@month (int minOccurs=l 

C3 

fO maxOccurs=l) specifies the month to recur on. 



fu 

m 

ejsa 
S 



The /getCaIendarDaysResponse/event/recurrence/rule/repeat/yearly/@day (int 
minOccurs=l maxOccurs=l) specifies the day of the month to recur on. The value is between 
C3 1-31, and forceExact, applies for invalid day-month combinations. Thus, by default, an 

ru 

ry 15 invalid day-month-year combination will cause .NET Calendar to search backwards to find a 

C3 

valid day for a particular month, year. If 

/getCalendarDaysResponse/event/recurrence/rule/repeat/yearly/@forceExact (boolean 
minOccurs=0 maxOccurs=l) is true, an invalid starting [month ,day] combination such as [6, 
31] is ignored and will not be included as an instance of the recurrence. With forceExact, 
20 .NET Calendar, day=3 1 will only pick up months that have 3 1 days, day=30 will pick up all 
months except February, day=29 will pick up all months except February, except on leap 
years. February 29 is included on leap years. 
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The /getCalendarDaysResponse/event/recurrence/rule/repeat/{any} (minOccurs=0 
maxOccurs=unbounded) allows for any additional repeat rules. 

The /getCalendarDaysResponse/event/recurrence/nile/windowEnd (dateTime 
minOccurs=0 maxOccurs=l) field indicates the end of the window over which the recurrence 
occurs. This is stored in UTC. The Maximum range is January 1, 1753 to December 31, 
9999 to an accuracy of 3.33 milliseconds. Note that windowEnd, repeatForever, 
repeatlnstances may be selectable. 

The ZgetCalendarDaysResponse/event/recurrence/rule/repeatForever (boolean 
minOccurs=0 maxOccurs=l) overrides the windowEnd date and specifies that this recurrence 
repeats forever. Client implementations cannot depend on date values repeating forever, like 
23:59:59pm Dec 31, 9999 or 23:59 Aug 31, 4500. 

The /getCalendarDaysResponse/event/recurrence/rule/repeatlnstances (int 
minOccurs=0 maxOccurs=l) overrides the windowEnd date and specifies that this recurrence 
repeats for the specified number of instances. As is apparent, repeatlnstances and 
repeatForever are mutually exclusive, but repeatlnstances will override repeatForever for 
errant schemas. 

Note that if the method causes a failure response to be generated, the failure is noted 
by generation of a SOAP FauU message. Failures can include a failure to understand a header 
marked as "s:mustUnderstand", a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 

The myCalendar/getFreeBusyDays Method is accessed using a request message, and in 
response may generate a response message or a SOAP Fault message. The following sample 
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a 
ru 



in 



document outlines and descriptions below illustrate the stracture and meaning of the elements 
and attributes in the request and response messages: 



<m:getFreeBusyDaysRequest 
xmbis:m="http://schemas.niicrosoft.coni/hs/2001/10/myCalendar" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 
<m:calendarType>o..i</m:calendarType> 
<m:startTime>i ..i</m:startTime> 
<m:endTime>i..i</m:endTime> 
<m:getFreeBlocks>o..i</m:getFreeBlocks> 

<m:retumIndividualBlocks>o..i</m:retumIndividualBlocks> 
<m:getFreeBusyDaysRequest> 



The ZgetFreeBusyDaysRequest (minOccurs=l maxOccurs=l) function returns a stream 
^ 5 of xml fragments defining the user's freeBusy information between two dates. Single events 
and recurring events within the time window are translated into blocks of free/busy time. 
The getFreeBusyDays only returns the blocks and their associated type. There is no explicit 
method to return unmerged freeBusy info, as that kind of behavior is fully contained within 
getCalendarDays. 



fy 10 This method follows the precedence order: Away(OOF), Busy, Tentative, Free 

fy 

J J Overiapping blocks of the same freeOrBusyStatus kind are coalesced to form larger blocks. 
Overtyping blocks of different freeOrBusyStatus are overlaid. The events with higher 
precedence overlay on top (not by starting time). For example. Busy from 8 to 9, Tentative 
from 8:30 to 10, OOF from 9:30 to 1 1, Free from 10:30 to 12, is merged as Busy from 8 to 9, 
15 Tentative from 9 to 9:30, OOF from 9:30 to 1 1, Free from 1 1 to 12. 

The freeBusy information of multiple users is retrieved by specifying a puid for each user in 
question. The caller of this function needs to specify their own puid, no implicit assumptions 
are made. 
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The calling method takes a startDate and an endDate to define the duration over which 
fi-eebusy information is returned. A third parameter determines if free blocks are explicitly 
retumed. Free blocks are intervals where no calendar object exists. 

The getFreeBusyDays method may be used to retrieve multiple calendar data from other users 
using <h:key instance="0" cluster="0" puid='*xyz"/> in the SOAP headers provided that puid 
"xyz" is provisioned on the .NET Calendar server, and provided that the user has been granted 
access in puid "xyz"'s rolelist. 

The ZgetFreeBusyDaysRequest/calendarType (string niinOccurs=0 maxOccurs=l) 
contains the optional calendar type to return, with the default being Gregorian. The 

ZgetFreeBusyDaysRequest/startTime (dateTime minOccurs=l maxOccurs=l) field 
contains the starting time window of calendar objects to retrieve. This dateTime also contains 
the timeZone to retrieve the calendar information in. 

The ZgetFreeBusyDaysRequest/endTime (dateTime minOccurs=l maxOccurs=l) field 
contains the ending time window to retrieve calendar objects. This dateTime also contains the 
timeZone to retrieve the calendar information in, and needs to be the same timeZone as 
startTime. 

The ZgetFreeBusyDaysRequest/getFreeBlocks (boolean minOccurs=0 maxOccurs=l) 
boolean causes .NET Calendar to explicitly return free time as freeBusy blocks. By default, 
free blocks are not retumed. The ZgetFreeBusyDaysRequest/retumlndividualBlocks (boolean 
minOccurs=0 maxOccurs=l) boolean causes .NET Calendar not to coalesceZmerge freeBusy 
information. By default, freeBusy information is merged. 
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upon successful completion of the getFreeBusyDays method, a 

myCalendar/getFreeBusyDaysResponse response message is generated. The format of the 

response message is described below: 

<m:getFreeBusyDaysResponse selectedNodeCount=". . status^", . 
xmhis:m="http://schemas.microsoft.com/hs/2001/10/myCalendar" 
xmhis:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 
<m:freeOrBusyEvent>o..unbounded 
<m: startTime>i 1 </m: startTime> 
<m:endTime>i i </m:endTime> 
<m:type>i..i</m:type> 
</m:freeOrBusyEvent> 
</m:getFreeBusyDaysResponse> 

The ZgetFreeBusyDaysResponse (minOccurs=l maxOccurs=l) response XML blob 
format, comprises freebusy xml fragments. The 

/getFreeBusyDaysResponse/@selectedNodeCount (int minOccurs=0 maxOccurs=l) attribute 
is used to return the number of selected nodes, selected by the corresponding data language 
operation. 

The /getFreeBusyDaysResponse/@status (string minOccurs=l maxOccurs=l) attribute 
indicates the status of the method, e.g., success when the corresponding method was 
completed successfully, failure when the corresponding method was not completed 
successfully, rollback when the method failed, but was rolled back to its pre-updateBlock 
status, or notAttempted when the corresponding method was not attempted. This occurs when 
a previous operation failed. 

The ZgetFreeBusyDaysResponse/freeOrBusyEvent (minOccurs=0 
maxOccurs=unbounded) includes ZgetFreeBusyDaysResponse/freeOrBusyEvent/startTime 
(dateTime minOccurs=l maxOccurs=l) which specifies the start time. 
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/getFreeBusyDaysResponse/freeOrBusyEvent/endTime (dateTime minOccxirs=l 
inaxOccurs=l) which specifies the end time, and 

ZgetFreeBusyDaysResponse/fi-eeOrBusyEvent/type (string minOccurs=l maxOccurs=l) which 
specifies the type, including fi-ee, tentative, busy or away. 

The myCalendar/getQuickView Method provides a QuickView/DatePicker service 
fiinction. The following table and description below describes the request message for this 
method: 

<m :getQuickViewRequest 

xmlns:m="http://schemas.microsoft.com/hs/2001/10/myCalendar" 

xmlns:hs="http://schemas.microsoft.coni/hs/2001/10/core">i..i 

<m:calendarType>o,.i</m:calendarType> 

<m:startTime>i..i</m:startTime> 

<m : endTime> i . . i </m : endTime> 

<m:tzid>o..i</m:tzid> 

<m:biasOffset>o..i</m:biasOffset> 
</m:getQuickViewRequest> 

The /getQuickViewRequest (minOccurs=l maxOccurs=l) fimction provides an 
efficient, lightweight means to query a date range to indicate days that have 1 or more 
appointments (1) and days without appointments (0), Outlook® and OWA® (Outlook® Web 
Access) use this for their datepicker fimctionality. The date range takes timeZone-specific 
start and end times, using just the year, month, and day. The time zone can be a simple bias, 
since this is merely a request for data. startTime and endTime are required to have the same 
time-zone bias. In effect, the method "overlays" the incoming tune zone onto the user's 
calendar to define the dayblocks for which the QuickView retums data. 

The ZgetQuickViewRequest/calendarType (string minOccurs=0 maxOccurs=l) 
provides a field for the Optional calendar type to retum, with the default being Gregorian. 
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The /getQuickViewRequest/startTime (dateTime minOccurs=l maxOccurs=l) field contains 
the starting time window of calendar objects to retrieve. This dateTime also contains the 
timeZone to retrieve the calendar information in. 

The ZgetQuickViewRequest/endTime (dateTime minOccurs=l maxOccurs=l) 
5 specifies the ending time window to retrieve calendar objects. This dateTime also contains the 
timeZone to retrieve the calendar information in. It must be the same timeZone as startTime. 

The /getQuickViewRequest/tzid (int minOccurs=0 maxOccurs=l) field optionally 
specifies a timezone to retrieve the quickView in. If this or biasOffset are both missing, 
TZ_UTC is assumed. The /getQuickViewRequest/biasOffset (int minOccurs=0 

C3 10 maxOccurs=l) field optionally specifies a numeric integer offset timezone bias to retrieve the 

□ 

W quickView in. tzid takes precedence over biasOffset (pending xsdxhoice). 

r 

fU 

f p Upon successfiil completion of the myCalendar/getQuickViewmethod, a 

i 

3 myCalendar/getQuickViewResponse response message is generated. The format of the 

C3 response message is described in the table and description below: 

ru 

<m:getQuickViewResponse selectedNodeCount="..." status-*..." 

xmhas:m="http ://schemas.microsoft.com/hs/200 1 /1 0/myCalendar" 
xmhis :hs="http ://schemas .microsoft . com/hs/200 1 / 1 0/core">i i 
<m:month m="..." year="...'*>i.. unbounded 

<m:day d="...">i.3i</m:day> 
</m:month> 

</m:getQuickViewResponse> 

15 

The /getQuickViewResponse (minOccurs=l maxOccurs=l) retum value of 
getQuickView is a Ust of calendar days grouped into months. The 

/getQuickViewResponse/@selectedNodeCount (int minOccurs=0 maxOccurs=l) attribute is 
used to retum the number of selected nodes, selected by the corresponding data language 
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operation. The /getQuickViewResponse/@status (string minOccurs=l maxOccurs=l) 
attribute indicates the status of the method, e.g., success when the corresponding method was 
completed successfully, failure when the corresponding method was not completed 
successfully, rollback when the method failed, but was rolled back to its pre-updateBlock 
status, or notAttempted when the corresponding method was not attempted. This occurs when 
a previous operation failed. 

The /getQuickViewResponse/month (minOccurs=l maxOccurs=unbounded) 
field specifies the month block for the grouping of calendar days. The 
/getQuickViewResponse/month/@m (int minOccurs=0 maxOccurs=l) provide a month 
number, restrict to between one and thirteen, (as some calendars have thirteen months). 

The /getQuickViewResponse/month/@year (int minOccurs=0 maxOccurs=l), 
provides the year, while the 

/getQuickViewResponse/month/day (boolean minOccurs=l maxOccurs=31) field 
specifies whether this day is fi-ee (0) or has at least one event on it or overlapping (1). The 
/getQuickViewResponse/month/day/@d (int minOccurs=0 maxOccurs=l) field specifies a 
day in this month. 

The myCalendar/sendMeeting method is directed to the organizer meeting request, is 

accessed using a request message, and in response may generate a response message or a 

SOAP Fault message. The following sample document fi-agments illustrate the structure and 

meaning of the elements and attributes in the request and response messages. The following 

table and description below describes the request message for this method: 

<m:sendMeetingRequest eventld="..." criticalChange="..." recurrenceld="..." 
continueOnFailure="..." deleteOnCompletion-*..." 
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xmlns:m="http://schemas.microsoftxom/hs/2001/10/m^ 
xmlns:hs="http://schemas.microsoftxoin/hs/2001/10/core^ 
<m:uninvite behavior="...*'>i..i 

<m:attendee deleteAttendee="...">o..unbounded 
<hs:name xml:lang="..." dir="...''>o..i</hs:name> 
<hs:puid>o. . i </hs :puid> 
<hs:email>o..i</hs:email> 
</m:attendee> 
</m:uninvite> 

<m:repIaceRequest select="..." useClientIds="..." minOccurs="..." maxOccurs="...">o..i 
<hs:options>o..i {any}</hs:options> 
<hs:attributes {any}="...">o..unbounded</hs:attributes> 
{any} 

</m:replaceRequest> 
<m:invite behavior="...**>i„i 

<m:attendee>o..unbounded 

<hs:naine xml:lang="..." dir="...">o..i</hs:name> 
<hs:puid>o.,i</hs:puid> 
<hs:email>o..i</hs:email> 
</m:attendee> 
</m:invite> 

</m:scndMeetingRequest> 



The purpose of this method is for a meeting organizer to invite and uninvite (cancel) 
attendees to this event. The /sendMeetingRequest (minOccurs=l maxOccurs=l) sendMeeting 
also sends updated invitations to existing invitees. Inviting a user to a single instance of a 
recurring event will cause only that instance to be sent. However, future updates to that event 
will overwrite the existing instance, including the case where an update is the full recurring 
event. Meeting requests will be sent out as attachments from an SMTP server. 
When inviting or uninviting, .NET Calendar searches for these existing attendees by puid first, 
and then by email address such that the puid receives precedence in the search predication. 
.NET Calendar will not allow multiple meeting requests/cancellations to the same puid or 



-113- 



email address within the scope of the same invite or uninvite block. However, an organizer 
may uninvite an attendee and then reinvite again (non-standard behavior). 

The /sendMeetingRequest/@eventId (string minOccurs=l maxOccurs=l) field 
contains the puid of the event which to send meeting invitations or cancellations to. This 
5 event must already exist within the .NET Calendar service. Additional server constraints are 
implemented which verify that potential updates to the attendee tables occur for this event 
only. This is a required field. 

The /sendMeetingRequest/@criticalChange (boolean minOccurs=0 maxOccurs=l) 
attribute, when set to "true", causes <lastUpdateTime> to be updated when invitations are sent 

C3 10 to the attendees. If "false", <lastUpdateTime> remains untouched. 

□ 

The /sendMeetingRequest/@recurrenceId (dateTime minOccurs=0 maxOccurs=l) 
Is optional recurrenceld allows the meeting organizer to send invitations for only a particular 

g instance of a recurring event. If the event is not a recurring event, or if recurrenceld does not 

M 

fj correspond to a valid instance/exception, sendMeetingRequest will fail with an error. 

ru 

[y 15 The /sendMeetingRequest/@continueOnFailure (boolean minOccurs=l maxOccurs=l) 

Q 

field specifies to .NET Calendar to continue performing the sendMeetingRequest even on a 
failure. Points of failure: <uninvite> may delete attendees, and the data language delete may 
encounter errors <updateRequest> may encounter data language errors. The optional final 
delete of the event may encounter errors. 
20 The /sendMeetingRequest/@deleteOnCompletion (boolean minOccurs=0 

maxOccurs=l) event will be deleted upon completion of this sendMeetingRequest. This 
behavior is intended for deleting a meeting and sending cancellations. If recurrenceld is 
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present (and valid), only this particular recurring instance or exception is deleted, in which 
case a new <deletedExceptionDate> is added to the recurrence rule. 

The /sendMeetingRequest/uninvite (minOccurs=l maxOccurs=l) includes The 
/sendMeetingRequest/uninvite/@behavior (string minOccurs=0 maxOccurs=l), an attribute 
that gives the option to either choose to send cancellations to "all" attendees in the event's 
attendee table, or send to "none" of them. A third value of "default" would give the default 
behavior of sending cancellations to all attendees who are replaced in the <replaceRequest> 
block. When this attribute is set, .NET Calendar will ignore anything within the <uninvite> 
node. 

The /sendMeetingRequest/uninvite/attendee (niinOccurs=0 maxOccurs=unbounded) 
field contains a list of people to uninvite. Uninvited attendees must akeady exist in the 
organizer's attendee table, or else these users are ignored. 

The /sendMeetingRequest/iminvite/attendee/@deleteAttendee (boolean minOccurs=0 
maxOccurs=l) field optionally specifies whether or not to delete this attendee fi-om the 
organizer's attendee table. If the attendee is not deleted, .NET Calendar will not know the 
status of this attendee because the status {not-sent, sent, cancelled} is not stored per-attendee. 

The /sendMeetingRequest/uninvite/attendee/name (string minOccurs=0 maxOccurs=l) 
optional element specifies the name for the enclosing element. The 
/sendMeetingRequest/uninvite/attendee/name/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 coimtry code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /sendMeetingRequest/uninvite/attendee/name/@dir (string 
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minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /sendMeetingRequest/uninvite/attendee/puid (string niinOccurs=0 maxOccurs=l) 
optional element specifies the PUID for the enclosing element. The 
/sendMeetingRequest/uninvite/attendee/email (string minOccurs=0 maxOccurs=l) optional 
name specifies an e-mail address for the enclosing element. 

The /sendMeetingRequest/replaceRequest (minOccurs=0 maxOccurs=l) replace 
request can only affect the meeting invitation in question, and is thus constrained to be only 
©select- Vm:myCalendar/m:event[@id=@eventId]/...". It will not be allowed to replace-on- 
null so that event creation cannot be a side-effect. The 

/sendMeetingRequest/replaceRequest/@select (string minOccurs=l maxOccurs=l) attribute 
selects an xdb:blue or an xdbrred. 

The /sendMeetingRequest/replaceRequest/@useClientIds (string minOccurs=0 
maxOccurs=l) attribute specifies that, if an xdb:blue item is created during an insert or 
replace operation, and an ID would normally be generated, the ID specified in the request 
content should be used instead of having .NET My Services generate an ID. AppUcations 
using this option must ensure that they are properly generating unique IDs in the form of 
UUIDs. They must also ensure that they do not assign the same ID to multiple xdbiblue 
items; this can happen if the insert select attribute selects multiple nodes. 

The /sendMeetingRequest/replaceRequest/@minOccurs (int minOccurs=0 
maxOccurs=l) optional attribute specifies the minimum nimiber of nodes that must be 
selected by the select operation in order for this operation to be successfiiUy attempted. The 
default value is zero, meaning that if no nodes are selected, the operation silently succeeds as 
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a non operation (**NOP"). A value of one means that a minimum of one node must be 
selected. In that case, if no nodes are selected, the operation fails with an error. 

The /sendMeetingRequest/replaceRequest/@maxOccurs (int minOccurs=0 
maxOccurs=l) optional attribute specifies the maximum number of nodes that may be 
selected by the select operation in order for this operation to be successfully attempted. The 
default value is unbounded. If the number of nodes selected by the select attribute is greater 
than this value, an error condition occurs. The /sendMeetingRequest/replaceRequest/options 
(minOccurs=0 maxOccurs=l) provide for options. 

The /sendMeetingRequest/replaceRequest/options/{any} (minOccurs=0 
maxOccurs=unbounded) includes /sendMeetingRequest/replaceRequest/attributes 
(minOcciu"s=0 maxOccurs=unboimded). This element is used to specify a single attribute to 
be manipulated by the .NET My Services data-manipulation primitives. For example, when 
used in an insertRequest, this element specifies an attribute to be inserted at the specified 
node. 

The /sendMeetingRequest/replaceRequest/attributes/@{any} (minOccurs=0 
maxOccurs=l) and/sendMeetingRequest/replaceRequest/{any} (minOccurs=0 
maxOccurs=unbounded) fields provide for extensibiUty. This element is a placeholder that 
indicates where the content of the item being replaced is to be specified. 

The /sendMeetingRequest/invite (minOccurs=l maxOccurs=l) includes the 
/sendMeetingRequest/invite/@behavior (string minOccurs=0 maxOccurs=l) attribute. This 
attribute will give the option to either choose to send invitations to "all" attendees in the 
event's attendee table, or send to "none" of them. A third value of "default" would give the 
default behavior of sending invitations to only the new attendees in the <replaceRequest> 
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block. When this attribute is set, .NET Calendar will ignore anything within the <invite> 
node. 

The /sendMeetingRequest/invite/attendee (minOccurs=0 maxOccurs=unbounded) 
field contains information about this attendee to be invited. An invited attendee must already 
5 exist in the organizer's attendee table. This attendee may originally be there prior to the 
sendMeetingRequest method, or be the result of the update operation to this meeting. To 
change the attendee's inviteType, the update operation should be used. 

When invitations are sent, the attendee's <responseTime> is set to the current time 
(now) as a side-effect. The /sendMeetingRequest/invite/attendee/name (string minOccurs=0 

It 

10 maxOccurs=l) optional element specifies the name for the enclosing element. The 

C3 

12 /sendMeetingRequest/invite/attendee/name/@xml:lang (minOccurs=l maxOccurs=l) required 

ry 

|ri attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 

fSS 



V 



described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /sendMeetingRequest/invite/attendee/name/@dir (string 
1 5 minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /sendMeetingRequest/invite/attendee/puid (string minOccurs=0 maxOccurs=l) 
optional element specifies the PUID for the enclosing element. The 
/sendMeetingRequest/invite/attendee/email (string minOccurs=0 maxOccurs=l) optional 
20 name specifies an e-mail address for the enclosing element. 

The myCalendar/respond method provides a method for invitees to respond to an 
invite. The following table and accompanying description below illustrate the structure and 
meaning of the elements and attributes in the request and response messages: 
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xmlns:m="http://schemas.microsoftxom/hs/2001/10/myCalendar" 
xmlns:hs="http://schemas.microsoftxoni/hs/2001/10/core'*>i..i 
<m:responseTime>o.. 1 </m:responseTime> 
<m:responseType>o..i</ni:responseType> 
<m:coimterProposeStartTime>o.i</m:coimterProposeStartTime> 
<m:counterProposeEndTime>o . 1 </m:counterProposeEndTime> 
<m:coimterProposeLocation>o.. 1 </m:counterProposeLocation> 
<m:responseBody xinl:lang="..." dir="...">o..i</m:responseBody> 
<m:eventld>i .i</m:eventld> 
<m:puid>i..i</m:puid> 

</m:respondRequest> 



The purpose of this method is for a meeting invitee to respond to an invitation. 
Invitees may accept, dechne, accept tentatively, or counterpropose in some means. Currently, 

O allow the counterproposing of time and location, but we may consider future additions. 

C3 

;^ 5 The /respondRequest (minOccurs=l maxOccurs=l) includes 

fO 

lf\ /respondRequest/responseTime (dateTime minOccurs^O maxOccurs=l), field is the 

3 reply time on each attendee, set to the current time (Now) when the organizer sends a meeting 

^3 invitation. When the attendee responds, they update their responseTime. When the organizer 



receives responses, they will honor only those that have a higher responseTime than what he 
10 or she maintains in his or her own copy of the event for each attendee. While processing the 

response, the organizer will update their responseTime. This guarantees that the organizer 

honors only the most recent response from the attendee. This is stored in UTC. 

The /respondRequest/responseType (string minOccurs=0 maxOccurs=l) accept status 

indicates the valid types of responses that an attendee can reply with {accept, decline, 
15 tentative, counterpropose} . The absence of this field indicates that no response has been 

recorded (either the invitation has not been sent, or that a reply has not been received). 



-119- 



The /respondRequest/connterProposeStartTime (dateTime minOcciirs=0 
maxOcciirs=l) field contains the counter proposal start time information. If 
responseType=[counterPropose], then either the startTime, endTime, or location, or all three 
can be present. This is the invitee's counterproposal for a new start time for the meeting. 
5 This is stored in UTC. 

The ZrespondRequest/counterProposeEndTime (dateTime minOccurs=0 
maxOccurs=l) field contains the counter proposal end time information. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new end time for the meeting. This 

blO is stored in UTC 

□ 

I ^ The ZrespondRequest/counterProposeLocation (string minOccurs=0 maxOccurs=l) 

g»ss» 
rs3 

field contains the coimter proposal location information, field contains the counter proposal 

sa 
sba 

s Start time information. If responseType=[counterPropose], then either the {startTime, 

C3 endTime}, or location, or both can be present. This is the invitee's counterproposal for a 

ru 

1 5 location for the meeting. 

The ZrespondRequest/responseBody (string niinOccurs=0 maxOccurs=l) field contains 
an optional message for invitees to include along with the response. The 
/respondRequest/responseBody/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3 166 country code as described in RFC 

20 1766. The value of this attribute indicates the language type of the content within this 
element. The /respondRequest/responseBody/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the base direction of directionally neutral text. Possible values 
include rtl (right to left) and Itr (left to right). 
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The /respondRequest/eventld (string minOccurs=l maxOccurs=l) field contains the 
eventid for the meeting, and the /respondRequest/puid (string minOccurs=l maxOccurs=l) 
field identifies the invitee. 

The myCalendar/updateReminder Method provides a Delegate fimction to the .NET 
5 Alerts service for creating or modifying calendar meeting reminders. The following sample 
document in the table and accompanying description below illustrate the structure and 
meaning of the elements and attributes in the request and response messages: 



<m:updateReminderRequest 
xmbis:m=="http://schemas.microsoftxom/hs/2001/10/myCalendar" 
xmlns :hs="http ://schemas.microsoft.com/hs/200 1/1 0/core'*>i ..1 
<m:reminder>i..i 
<m:set>i..i</m:set> 

<m:to xml:lang="..." dir="...">i..i</m:to> 
<m:offset>i..i</m:offset> 
<m:interruptability>o..i</m:interruptability> 
<m:lastSentTime>i..i</m:lastSentTime> 
<m:nextTriggerTime>i..i</m:nextTriggerTime> 
</m:reminder> 
<m:id>i..i</m:id> 
</m:updateReminderRequest> 

fU 

The /updateReminderRequest (minOccurs=l maxOccurs=l) fimction is used to update 
1 0 the status of a reminder once the user has received the notification. It also may be exposed as 
an HTTP API so that non-.NET My Services clients have a means to dismiss, snooze, or be 
reminded again at a different time. The /updateReminderRequest/reminder (minOccurs=l 
maxOccurs=l) includes the /updateReminderRequest/reminder/set (boolean minOccurs=l 
maxOccurs=l) Boolean flag that indicates whether the reminder is active for this event. In 
15 most cases, this will be true, but in the case of a recurring appointment, this flag may default 
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to true with specific instances not to be reminded, or default to false, with specific instances to 
be reminded. 

The /updateReminderRequest/reminder/to (string minOccurs=l maxOccurs=l) field 
contains the friendly name that this reminder is being sent to. The 
5 /updateReminderRequest/reminder/to/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /updateReminderRequest/reminder/to/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 

f 3 1 0 Valid values are rtl (right to left) and Itr (left to right). 

□ 

The /updateReminderRequest/reminder/offset (int minOccurs=l maxOccurs=l) field 

til 

specifies the offset, in minutes, of how long before the event the user should be reminded. 



Recommended values are the following: 



£3 

ry 


Value 


Description 


ru 


5, 10, 20, 30, 45 


5, 10, 20, 30, 45 minutes before the event 




60, 120, 180, 


1, 2, 3 hours before the event 




startTime - startDay 


The day of the event (reminder sent at 12:00am) 




startTime - (startDay - 
(1440 * x)) 


"x" days before the event (reminder sent at 12:00am 
"x" days before) 



1 5 The /updateReminderRequest/reminder/interruptability (int minOccurs=0 

maxOccurs=l) optional element defines how interruptible this event is and it is used by 
notification routing software to make decisions about the relay and deferral of notifications 



-122- 



OlO 

ru 

ru 
en 

jsa 
«^ 

ru 
ru 
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that might occur while this meeting is active. The value contained in this element is a 
numeric value between one and ten. Low values represent a high cost of disruption, high 
values represent a low cost of disruption. 

The /updateReminderRequest/reminder/lastSentTime (dateTime minOccurs=l 
maxOccurs=l) is used by the reminder engine. The 

/updateReminderRequest/reminder/nextTriggerTime (dateTime minOccurs=l maxOccurs=l) 
field determines the next time to trigger reminder. The /updateReminderRequest/id (string 
minOccurs=l maxOccurs=l) attribute contains a reference to another .NET My Services item 
by its item ID. The uuidType is used to specify a universally unique identifier (UUID). 

Upon successful completion of this method, a Standard .NET My Services response 
message is generated as the myCalendar/updateReminderResponse. 

mvCalendar / Examples 

By way of example, .consider this stripped-down view of a sample user's calendar: 



<myCalendar> 
<event> 



<body> 



<cat ref="hs:public"/> 

<title xml:lang="en" dir="ltr">Meet with attomeys</title> 
<startTime> 2001-09-14T19:00:00Z </startTime> 
<endTime> 2001-09-14T20:00:00Z </endTime> 
<organizer> 

<name>John Doe</name> 

<email>johndoe@microsoft.com</email> 
</organizer> 



15 



</body> 
</event> 
</myCalendar> 
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As can be seen from the various descriptions above, when interpreted by a calendar 
appUcation, this would result in a single meeting on the calendar that takes place at noon 
Pacific Standard Time and lasts one hour. 

As a more complex example, consider the following table: 



<m:myCalendar 

xmlns:m="http ://schemas .microsoft.com/hs/200 1 / 1 0/myCalendar" 
xmlns:hs="http://schemas.microsoft.coni/hs/2001/10/core"> 
<m:event 

calendarType=="2"> 

<m:body> 

<m:title xml:lang="en" dir="ltr">Meet for coffee</m:title> 
<m:fullDescription xml:lang="en" dir="ltr"> 

Meet at the local coffee place to discuss 

our meeting this Monday. 

It takes about 30 minutes to get there. 
<m: fullDescription> 

<m:location> Joe's coffee shop</m:location> 

<startTime>2001-09-14T13:20:00-8:00</startTime> 

<endTime>2001-09-14T14:20:00-8:00</endTime> 

<allDay>False</allDay> 

<travelTimeTo>30</travelTimeTo> 

<travelTimeFrom>30</travelTimeFrom> 

<freeBusyStatus>away</freeBusyStatus> 

<m:organizer> 

<hs:name xml:lang="en" dir="rtr'>Bob Smith</hs:name> 
<hs:email>bobsmith@company.com</hs:email> 

</m:organizer> 
</m:body> 
<m:attachment> 

<m:name xml:lang="en" dir="rtl"> 
Meeting Agenda.doc 

</m:name> 

<m:contentType>application/msword</m:contentType> 
<m:contentTransferEncoding> 
base64 

</m: contentTransferEncoding> 
<m: size> 1 43 24</m: size> 

<m:content>4234234##32423423423423</m:content> 
</m:attachment> 
<m:reminder> 

<m: set>true</m: set> 

<m:to xml:lang="en" dir="rtl"></m:to> 

<m:offset>30</m:offset> 

<m:lastSentTime>0000-00-OOTOO:00:00</m:lastSentTime> 
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<m:nextTriggerTime> 

2001-09-14X12:50:00-8:00 
</m:nextTriggerTime> 
</m:reminder> 
</m:event> 
<m:event> 
<m:body> 

<m:cat ref="hs:public"/> 

<m:title xml:lang="en" dir="...">Monday morning meeting</m:title> 
<m:fullDescription xml:lang="en" dir="rtl"> 
Meet to talk about tasks for the upcoming week. 

</m: fiillDescription> 

<m:location xml:lang="en" dir="rtr'> Joe's coffee shop</m:location> 

<m:recurrenceld>200 1 -09-0 1 T08 :00-8 :00<;/m:recurrenceId> 

<m:startTime>200 1 -09-0 1 T08 : 00-8 :00</m: startTime> 

<m:endTime>200 1 -09-0 1 T09:00-8:00</m:endTime> 

<m:allDay>false</m:allDay> 

<m: floating>false</m: floating> 

<m:travelTimeTo>30</m:travelTimeTo> 

<m:travelTimeFrom>30</m:travelTimeFrom> 

<m:freeBusyStatus>busy</m:freeBusyStatus> 
</m:body> 
<m:recurrence> 

<m:rule> 

<m:creationDate>200 1 -09-0 1 T08:00-8:00</m:creationDate> 

<m:firstDayOfWeek>su</m:firstDayOfWeek> 

<m:isLeapYear>false</m:isLeapYear> 

<m:repeat> 

<m:weekly su="..." mo="true" tu="..." we="..." 

th="..." fr="..." sa="..." weekFrequency="..."/> 
<m:monthlyByDay su="..." mo="..." tu=",.." we="..." 

th="..." fr="..." sa="..." 

monthFrequency="..." weekdayOfMonth="..."/> 
<m:monthly monthFrequency="..." day="..." 

forceExact="..;V> 
<m:yearlyByDay su="..," mo=",.." tu="..." we="..." 

th="..." fr="..." sa="..." yearFrequency="..." 
weekdayOfMonth="..." month=",..'V> 
<m:yearly yearFrequency="..." month-'..." day="..." 

forceExact="..."/> 

</m:repeat> 

<m: windowEnd>2002-0 1 -0 IT 1 2 :00</m: windowEnd> 
<m:repeatForever>false</m:repeatForever> 
<m:repeatlnstances/^ 
</m:rule> 
</m:recurrence> 
</m:event> 
</m:myCalendar> 
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As can be seen from the descriptions above, this user has two events in a calendar. 
One event is recurring every Monday at 8:00 am, and the other is an upcoming event at 1 :20 
pm. 

As can be seen from the foregoing detailed description, there is provided a schema- 
based calendar service that allows users to access their data based on their identities and 
corresponding roles with respect to the data. The schema-based calendar service provides 
calendar data access independent of the application program and device, and in a centrally- 
accessible location such as the Intemet. The schema-based calendar service is extensible to 
handle extended contact information. 

While the invention is susceptible to various modifications and alternative 
constructions, certain illustrated embodiments thereof are shown in the drawings and have 
been described above in detail. It should be understood, however, that there is no intention to 
limit the invention to the specific forms disclosed, but on the contrary, the intention is to cover 
all modifications, altemative constructions, and equivalents falling within the spirit and scope 
of the invention. 
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